다음을 통해 공유

Kubernetes용 IRCTL 지원 자체 호스팅 통합 런타임

  • 아티클

Microsoft Purview Kubernetes SHIR을 로컬로 관리하려면 IRCTL이라는 명령줄 도구가 필요합니다. SHIR 생성 프로세스 중에 이 도구를 다운로드할 수 있습니다. IRCTL은 Microsoft Purview SHIR을 관리하는 명령줄 도구입니다.

필수 구성 요소

IRCTL에 대한 시스템 요구 사항은 다음과 같습니다.

  • IRCTL을 실행하는 컴퓨터 - OS는 Linux 또는 Windows에서 TLS 1.2를 지원합니다.
  • IRCTL을 실행하는 컴퓨터는 다음 엔드포인트에 연결할 수 있어야 합니다.
Domain name 아웃바운드 포트 설명
퍼블릭 클라우드: *.compute.governance.azure.com
Azure Government:*.compute.governance.azure.us
중국: *.compute.governance.azure.cn		 443 Microsoft Purview 서비스에 연결하는 데 필요합니다. Microsoft Purview 프라이빗 엔드포인트를 사용하는 경우 이 엔드포인트는 계정 프라이빗 엔드포인트에서 다룹니다.
  • Kubernetes 컨텍스트: Kubernetes 클러스터 정보와 이 클러스터에 대한 사용자 권한 및 자격 증명을 포함하는 Kubernetes 컨텍스트는 Kubernetes 클러스터와 통신하는 데 필요합니다. SHIR 관리에 대한 사용자의 권한에 대한 구성을 용이하게 하기 위해 Kubernetes 관리 역할로 시작할 수 있습니다. 이 컨텍스트는 Kubernetes 클러스터를 설치하여 생성되고 구성 파일에 저장됩니다. 이 파일을 가져올 수 있는 위치와 방법은 Kubernetes 클러스터 설정에 따라 달라집니다.
    • 를 사용하여 kubeadm init Kubernetes 클러스터를 설정하는 경우 에서 /etc/Kubernetes/admin.conf구성 파일을 찾을 수 있습니다.
    • AKS를 사용하는 경우 AKS의 지침에 따라 Az PowerShell 모듈 명령을 사용하여 이 클러스터의 자격 증명을 로컬 컴퓨터에 가져올 수 있습니다. 컨텍스트를 아래 $HOME/.kube/config 의 구성 파일에 직접 병합할 수 있습니다.
    • Kubernetes 클러스터를 설정하는 다른 도구를 사용하는 경우 Kubernetes 설명서를 참조하세요.
    • Kubernetes 컨텍스트의 구성 파일이 있는 경우 IRCTL 명령을 실행하려는 컴퓨터의 구성 파일 $HOME/.kube/config()에 병합합니다. 또는 KUBECONFIG라는 환경 변수에서도 Kubernetes 컨텍스트의 구성 파일을 설정할 수 있습니다. Kubernetes 컨텍스트에 대한 자세한 내용은 여러 클러스터에 대한 액세스 구성을 참조하세요.

IRCTL 설치 및 실행

Kubernetes 지원 자체 호스팅 통합 런타임을 제어하고 관리하기 위해 사용자는 IRCTL이라는 명령줄 도구를 다운로드할 수 있습니다. 사용자는 IRCTL 및 kubectl 명령줄을 통해 포털에서 상태 모니터링할 수도 있습니다. 다음은 Kubernetes에서 지원하는 자체 호스팅 통합 런타임에 대한 단계입니다.

Windows용 최신 IRCTL 다운로드

특정 버전

특정 버전의 IRCTL을 다운로드하려면 URL에서 버전 세그먼트를 변경합니다. https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

버전 1.0.0의 예: https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

사용 가능한 IRCTL 버전은 IRCTL 릴리스 정보에서 찾을 수 있습니다.

도구를 다운로드한 후:

  1. 도구 폴더의 압축을 풀고 엽니다.

  2. 명령줄에서 액세스할 수 있는 컴퓨터의 위치로 이동합니다.

  3. 명령줄을 열고 IRCTL 애플리케이션이 보관된 폴더로 이동합니다.

  4. 아래 명령을 사용하여 IRCTL과 상호 작용하고 다음 단계에 따라 Kubernetes 지원 통합 런타임을 설치합니다.

IRCTL 명령 세부 정보

Microsoft Purview의 통합 런타임 설정에서 IRCTL 명령줄 도구를 다운로드할 수 있습니다. 통합 런타임을 선택하고 설정 에서 IRCTL 다운로드 및 통합 런타임 설치 링크를 볼 수 있습니다. 도구를 다운로드하려면 선택합니다.

IRCTL 명령줄을 사용하여 Kubernetes 지원 자체 호스팅 통합 런타임을 설정하거나 관리할 수 있습니다. 이 구문을 사용하여 터미널 창에서 IRCTL 명령을 실행합니다.

./irctl [command][flags]...
  • 명령은 수행하려는 작업을 지정합니다.
  • Flags 는 작업에 대한 매개 변수를 지정합니다.
명령 설명
구성(config) IRCTL 구성 관리
창조하다 새 SHIR 리소스 만들기
삭제하다 SHIR 리소스 삭제
묘사하다 Kubernetes 클러스터에서 실행되는 SHIR에 대해 설명합니다.
도움말 모든 명령에 대한 도움말 제공
보관 SHIR용으로 예약된 로컬 스토리지 관리
로그 SHIR 로그 관리
업그레이드 IRCTL을 사용하여 SHIR을 동일한 버전으로 업그레이드

구성(Config)

IRCTL 구성을 관리합니다.

./irctl config [flags]
./irctl config [command]
명령 설명
집합 하나의 SHIR 구성을 수정합니다.
보기 모든 SHIR 구성을 봅니다.
기 매개 변수 형식 설명
-h,--help 구성에 대한 도움말

구성 집합

자체 호스팅 통합 런타임 구성 하나를 수정합니다.

./irctl config set <config-name> <config-value> [flags]
기 매개 변수 형식 설명
-c, --context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 구성에 대한 도움말

구성 보기

모든 SHIR 구성을 봅니다.

./irctl
기 매개 변수 형식 설명
-c, --context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 구성에 대한 도움말

허용되는 SHIR 구성

구성 이름 구성 유형 유효한 값 기본값(설정되지 않은 값) 설명 다시 설치를 통해 유지
autoUpdate.enabled 부울 true/false true 현재 SHIR을 자동으로 업데이트할지 여부를 제어합니다. 예

만들기

새 SHIR 리소스를 만듭니다.

./irctl create [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 만들기 도움말
-r,--registration-key 문자열 SHIR을 등록하는 키
-s,--선정자 문자열 필터링할 노드 선택기(레이블 쿼리)는 '='를 지원합니다. (예:,--선삭자 key1=value1,key2=value2) 실행할 SHIR에 대해 지정된 레이블로 노드를 선택합니다. 기본값은 비어 있습니다. 즉, SHIR은 모든 노드에서 실행됩니다.

예:

./irctl create --registration-key 1234@keyvalue

업그레이드

IRCTL을 사용하여 SHIR을 동일한 버전으로 업그레이드합니다.

./irctl upgrade [flags]
./irctl upgrade [command]
명령 설명
상태 최신 SHIR 업그레이드 상태 모니터링합니다.
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 업그레이드 도움말

삭제

SHIR 리소스를 삭제합니다.

./irctl delete [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 삭제에 대한 도움말

묘사하다

Kubernetes 클러스터에서 실행되는 SHIR에 대해 설명합니다.

./irctl describe [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 설명에 대한 도움말

Storage

SHIR 공유 스토리지에서 파일을 관리합니다.

./irctl storage [flags]
./irctl storage [command]
명령 설명
업로드 SHIR 공유 스토리지에 파일을 업로드합니다.
목록 SHIR 공유 스토리지의 파일을 나열합니다.
삭제하다 SHIR 공유 스토리지에서 파일을 삭제합니다.
기 매개 변수 형식 설명
-h,--help 스토리지에 대한 도움말

스토리지 업로드

SHIR 공유 스토리지에 파일을 업로드합니다.

./irctl storage upload -s <source> -d <destination> [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-d,--destination 문자열 문자열 SHIR 공유 스토리지에 업로드된 파일/폴더를 저장하는 경로입니다.
-h,--help 삭제에 대한 도움말
-s,--source 문자열 업로드할 파일/폴더의 경로입니다.

스토리지 목록

SHIR 공유 스토리지의 파일을 나열합니다.

./irctl storage list <path> [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 목록에 대한 도움말입니다.

스토리지 삭제

SHIR 공유 스토리지에서 파일을 삭제합니다.

./irctl storage delete <path> [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 삭제에 대한 도움말입니다.

로그

SHIR에서 로그 작업.

./irctl log [flags]
./irctl log [command]
명령 설명
업로드 SHIR에서 로그를 업로드합니다.
다운로드 SHIR에서 로그를 다운로드합니다.
기 매개 변수 형식 설명
-h,--help 로그에 대한 도움말입니다.

로그 업로드

SHIR에서 로그를 업로드합니다.

./irctl log upload [flags]
./irctl log upload [command]
명령 설명
상태 SHIR 로그 업로드의 상태 모니터링합니다.
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-h,--help 업로드에 대한 도움말입니다.
-t,--timeout int 로그 업로드 작업의 시간 제한(초): [900, 3600]. 기본값은 900초입니다. (기본값 900)

로그 다운로드

SHIR에서 로그를 업로드합니다.

./irctl log download [flags]
기 매개 변수 형식 설명
-c,--context 문자열 사용할 Kubernetes 컨텍스트의 이름이 지정되지 않은 경우 Kube 구성의 현재 컨텍스트가 사용됩니다.
-d,--destination 문자열 SHIR에서 다운로드한 로그를 저장하는 로컬 경로입니다.
-h,--help 다운로드에 대한 도움말입니다.

다음 단계