자체 호스팅 통합 런타임을 위한 DIRCTL 도구 설정(미리 보기)

DIRCTL(데이터 통합 런타임 명령줄)은 입니다. Kubernetes 클러스터 내에서 데이터 통합 런타임 관리를 자동화하는 NET 기반 CLI(명령줄 인터페이스) 도구입니다. 간단한 명령으로 복잡한 Kubernetes 작업을 간소화하고 등록 및 토큰 수명 주기 관리를 위해 Microsoft Purview와의 보안 통신을 보장합니다.

Microsoft Purview Kubernetes 자체 호스팅 데이터 통합 런타임을 로컬로 관리하려면 DIRCTL 명령줄 도구가 필요합니다. 데이터 통합 런타임 생성 프로세스 중에 이 도구를 다운로드할 수 있습니다. Windows 및 Linux 운영 체제에 대한 아래 설정 지침을 참조하세요.

DIRCTL CLI용 Windows 설치

  1. Kubectl CLI 도구를 다운로드하여 설치합니다.
  2. 생성된 kube 구성 파일을 다음 경로 C:/Users/<user-folder>/.kube/에 따라 사용자별 폴더에 배치합니다. 파일을 복사하고 구성 이름을 지정 합니다.

    참고

    이 구성 파일은 Kubernetes 클러스터에서 DIRCTL 인증에 필요합니다.

  3. Windows용 DIRCTL CLI 패키지 .zip 다운로드합니다.
  4. 로컬 컴퓨터의 기본 디렉터리에 콘텐츠를 추출합니다.
  5. Windows에서 터미널을 엽니다.
  6. 추출된 DIRCTL 디렉터리로 이동합니다.
  7. cd 명령을 <path-to-dirctl> 사용하여 폴더로 이동합니다.
  8. DIRCTL'을 사용하여 ./명령을 실행합니다.

DIRCTL CLI에 대한 Linux 설정

  1. Linux 배포에 대한 kubectl CLI를 다운로드하고 설치합니다.
  2. Kubernetes에 대한 인증을 위해 kubeconfig 파일을 기본 kube 폴더 ~/.kube/에 배치합니다.
  3. 생성된 kubeconfig 파일을 사용자별 디렉터리에 복사합니다. 파일 이름이 config인지 확인합니다. mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    참고

    이 구성 파일은 Kubernetes 클러스터에서 DIRCTL 인증에 필요합니다.

  4. Windows 또는 Linux 대한 DIRCTL CLI 패키지를 다운로드합니다.
  5. 터미널을 열고 DIRCTL 디렉터리로 이동합니다. cd /your/target/directory/DIRCTL
  6. 를 사용하여 ./DIRCTL 명령을 실행합니다.

DIRCTL 명령

  1. DIRCTL 도움말: 도움말 명령은 DIRCTL 도구 내에서 사용 가능한 모든 명령 및 기능에 대한 포괄적인 개요를 제공합니다. 이렇게 하면 데이터 통합 작업에 대한 지침과 컨텍스트를 제공하여 도구를 효과적으로 사용할 수 있습니다.

  2. DIRCTL 다시 등록: ./DIRCTL re-register –registration-key <re-registration-key-value> 새 등록 키를 사용하여 오랜 시간 동안 비활성 상태인 경우 다시 등록 명령을 사용하여 기존 데이터 통합 런타임 리소스를 다시 등록합니다.

  3. DIRCTL 삭제: ./DIRCTL delete 시스템에서 데이터 통합 런타임을 등록 취소하고 연결된 모든 애플리케이션 Kubernetes Pod를 해제하려는 경우 Delete 명령은 간소화된 솔루션을 제공합니다. 이 명령은 SQL Server DQS(Data Quality Services)에서 DIR을 완전히 제거하여 런타임 또는 해당 애플리케이션 Pod의 잔재가 남아 있지 않도록 합니다. 또한 명령은 DIR 애플리케이션과 연결된 실행 중인 모든 Kubernetes Pod의 종료를 처리하여 시스템 내의 리소스를 확보합니다.

  4. DIRCTL 업그레이드: ./DIRCTL upgrade –v <image version> 업그레이드 명령을 사용하면 데이터 통합 런타임 버전을 사용자가 지정한 사용 가능한 최신 버전으로 원활하게 업그레이드할 수 있습니다. 이 프로세스를 통해 데이터 통합 런타임은 최신 기능, 향상된 기능 및 보안 패치와 함께 작동하여 시스템 내에서 호환성과 효율성을 유지합니다.

  5. DIRCTL 설명: ./DIRCTL describe Describe 명령은 실행 중인 DIR 및 DIRCTL 애플리케이션의 상태 성능에 대한 자세한 인사이트를 제공합니다. 애플리케이션 Pod의 상태를 검사하여 문제 또는 변칙이 즉시 식별되는지 확인합니다. 이 기능은 런타임 환경에 대한 가시성을 제공하여 문제 해결 및 사전 관리 시스템 유지 관리를 지원합니다.

  6. DIRCTL 로그: ./DIRCTL log download –d <relative-destination-folder-path> Log 명령을 사용하여 모든 활성 데이터 통합 런타임 애플리케이션 Pod의 로그를 지정된 대상 폴더 경로에 다운로드합니다. 이 기능은 자세한 런타임 레코드에 액세스할 수 있도록 하기 때문에 디버깅, 성능 모니터링 또는 감사 활동에 특히 중요합니다. 포괄적인 로그를 유지하면 패턴, 변칙 및 잠재적 문제를 효과적으로 식별하여 시스템 유지 관리 및 최적화의 핵심 도구가 될 수 있습니다.

  7. DIRCTL 구성: ./DIRCTL config auto-update-enable <true/false> 자동 업데이트 사용 구성을 false 또는 true로 업데이트합니다.

  • Last updated on