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

중요

Microsoft Purview 통합 카탈로그 및 클래식 Microsoft Purview 데이터 거버넌스 기능(이전의 Azure Purview)은 사용 중지됩니다. Microsoft는 Microsoft Fabric에서 데이터 거버넌스 기능을 통합하고 있습니다. 더 이상 새 계정을 만들 수 없으며 기존 기능은 2027년 11월 12일까지 유지 관리 모드로 유지됩니다. 사용 중지 일정, 전환 지침 및 권장되는 다음 단계는 Microsoft Purview 데이터 거버넌스 사용 중지 공지를 참조하세요.

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

필수 구성 요소

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

  • IRCTL을 실행하는 컴퓨터 - OS가 TLS 1.2를 지원하는 Linux 또는 Windows입니다.
  • 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 클러스터 설정에 따라 달라집니다.
    • Kubernetes 클러스터를 설정하는 데 사용하는 kubeadm init 경우 아래에서 /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에서 지원하는 자체 호스팅 통합 런타임에 대한 단계입니다.

특정 버전

특정 버전의 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]...
  • 명령은 수행할 작업을 지정합니다
  • 플래그는 작업에 대한 매개 변수를 지정합니다.
명령 설명
구성 IRCTL 구성 관리
만들기 새 SHIR 리소스 만들기
삭제 SHIR 리소스 삭제
설명 Kubernetes 클러스터에서 실행되는 SHIR에 대해 설명합니다.
도움말 모든 명령에 대한 도움말을 제공합니다.
저장 공간 SHIR용으로 예약된 로컬 저장소 관리
로그 SHIR의 로그 관리
업그레이드 IRCTL을 사용하여 동일한 버전으로 SHIR을 업그레이드

구성

IRCTL 구성을 관리합니다.

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

구성 집합

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

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

구성 보기

모든 SHIR 구성을 봅니다.

./irctl 
플래그 매개 변수 형식 설명
-c, --문맥 문자열 사용할 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,--selector 문자열 필터링할 노드 선택기(레이블 쿼리)는 '='를 지원합니다. (예,--selector 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 string 문자열 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 다운로드에 대한 도움말입니다.

다음 단계