플러그인을 개발할 때 Automation Orchestrator 서버를 디버그 모드에서 시작하여 문제를 디버깅할 수 있습니다.

사전 요구 사항

로컬 시스템에 Kubernetes 명령줄 도구를 설치하고 구성합니다. kubectl 설치 및 설정을 참조하십시오.

프로시저

  1. Automation Orchestrator Appliance 명령줄에 root로 로그인합니다.
  2. kubectl -n prelude edit deployment vco-app 명령을 실행합니다.
  3. vco-server-app 컨테이너에 디버그 환경 변수를 추가하여 배포 YAML 파일을 편집합니다. 변수는 vco-server-app 컨테이너의 env 섹션에 추가해야 합니다.
    containers:
          - command:
          ...
            env:
            - name: DEBUG_PORT
              value: "your_desired_debug_port"
          ...
    	name: vco-server-app
          ...
    참고: env 섹션에 디버그 환경 변수를 추가할 때 이전 예제에 나와 있는 것처럼 YAML 들여쓰기 형식을 따라야 합니다.
  4. 변경 내용을 배포 파일에 저장합니다.
    배포 파일에 대한 편집이 성공하면 deployment.extensions/vco-app edited 메시지를 받게 됩니다.
  5. vracli dev kubeconfig 명령을 실행하여 Kubernetes 구성 파일을 생성합니다.
    kubeconfig는 개발자 환경이기 때문에 계속할지 여부를 묻는 메시지가 표시됩니다. 계속하려면 yes를 입력하고 중지하려면 no를 입력합니다.
  6. 생성된 구성 파일의 컨텐츠를 apiVersion: v1에서 client-key-data 컨텐츠까지 포함하여 복사합니다.
  7. 생성된 Kubernetes 구성 파일을 로컬 시스템에 저장합니다.
  8. Automation Orchestrator Appliance에서 로그아웃합니다.
  9. 로컬 시스템에서 디버그 모드 구성을 완료합니다.
    1. 명령줄 셸을 엽니다.
    2. KUBECONFIG 환경 변수를 저장된 구성 파일에 바인딩합니다.
      참고: 이 예는 Linux 환경을 기반으로 합니다.
      export KUBECONFIG=/file/path/fileName
    3. 서비스가 실행 중인지 확인하려면 kubectl cluster-info 명령을 실행합니다.
    4. 디버그 모드 구성을 완료하려면 다음 Kubernetes API 요청을 수행합니다.
      참고: localhost_debug_port 변수 값은 IDE(통합 개발 환경)의 원격 디버깅 구성에 설정된 포트입니다. vro_debug_port 변수의 값은 이 절차의 3단계에서 생성됩니다.
      kubectl port-forward pod/vco_app_pod_ID localhost_debug_port:vro_debug_port
    중요: 디버깅 도구를 구성할 때 포트 전달 명령을 수행한 로컬 시스템의 DNS 및 IP 설정을 제공합니다.

결과

Automation Orchestrator Appliance에 대한 서버 디버깅이 구성되었습니다.