Anthos-gke aws 관리

anthos-gke aws management의 명령어는 AWS 관리 서비스에서 GKE를 배포하고 삭제합니다. init 및 apply 명령어를 사용하여 관리 서비스를 프로비저닝합니다. get-credentials 명령어를 사용하여 관리 서비스에 인증하고 delete 명령어를 사용하여 AWS 환경에서 GKE를 제거합니다. diagnose 명령어를 사용하여 디버깅을 위한 추가 정보를 수집할 수 있습니다.

Init

anthos-aws init 명령어는 다음을 수행합니다.

• anthos-gke.yaml 파일이 포함된 작업 디렉터리를 준비합니다.
• 구성을 검증합니다. 검증 중에 init은 anthos-gke.yaml 파일에 모든 필수 필드가 포함되어 있는지, 사용자에게 충분한 권한이 있는지, AWS KMS와 같은 참조 리소스가 있는지 확인합니다.
• 상태 정보를 만들거나 anthos-gke-status.yaml에 추가합니다. 이 파일에는 생성된 클러스터 ID, SSH 공개 키, 암호화된Google Cloud 서비스 계정 키, 암호화된 Kubernetes CA 인증서가 포함됩니다.

anthos-gke init을 실행하고 anthos-gke apply를 시행합니다.

anthos-gke aws management init DIRECTORY

위치 인수

DIRECTORY

anthos-gke.yaml 파일이 포함된 디렉터리의 선택적 인수입니다. 기본값은 현재 디렉터리입니다.

예

현재 작업 디렉터리를 초기화하려면 다음 명령어를 실행합니다.

anthos-gke aws management init

특정 디렉터리를 초기화하려면 다음 명령어를 실행합니다.

anthos-gke aws management init DIRECTORY

DIRECTORY를 anthos-gke.yaml 파일이 포함된 디렉터리로 바꿉니다.

적용

중요: anthos-gke.yaml 파일을 만들거나 업데이트할 때 anthos-gke aws management init를 실행하고 apply를 실행해야 합니다.

apply 명령어는 AWS에서 관리 서비스를 프로비저닝합니다. 이 명령어는 AWS의 GKE가 Terraform 상태에 사용하는 Cloud Storage 버킷도 만듭니다.

anthos-gke aws management apply DIRECTORY

위치 인수

DIRECTORY

anthos-gke.yaml 파일이 포함된 디렉터리의 선택적 인수입니다. 기본값은 현재 디렉터리입니다.

예

현재 작업 디렉터리의 구성에서 관리 서비스를 만들려면 다음 명령어를 실행합니다.

$ anthos-gke aws management apply

특정 디렉터리(예: ~/example/workspace)의 구성에서 관리 서비스를 만들려면 다음 명령어를 실행합니다.

$ anthos-gke aws management apply DIRECTORY

DIRECTORY를 anthos-gke.yaml이 있는 디렉터리로 바꿉니다.

Get-credentials

get-credentials 명령어는 관리 서비스의 사용자 인증 정보 및 엔드포인트 정보로 kubeconfig 파일을 업데이트합니다. 기본적으로 사용자 인증 정보는 ~/.kube/config에 추가됩니다. KUBECONFIG 환경 변수를 설정하여 kubeconfig에 다른 경로를 설정할 수 있습니다.

anthos-gke aws management get-credentials [--workspace DIRECTORY]

플래그

--workspace DIRECTORY

anthos-gke.yaml 파일이 포함된 디렉터리의 선택적 인수입니다. 기본값은 현재 디렉터리입니다.

예

현재 작업 디렉터리에 정의된 관리 서비스의 사용자 인증 정보를 가져오려면 다음 명령어를 실행합니다.

anthos-gke aws management get-credentials

특정 디렉터리에 정의된 관리 서비스의 사용자 인증 정보를 가져오려면 다음 명령어를 실행합니다.

anthos-gke aws management get-credentials --workspace DIRECTORY

DIRECTORY를 anthos-gke.yaml이 있는 디렉터리로 바꿉니다.

진단

diagnose snapshot 명령어는 Google 지원에서 관리 서비스 문제 디버그할 수 있도록 지원 번들을 생성합니다. 지원 번들은 구성, 클러스터 이벤트, 로그가 포함된 tar 파일입니다. 자세한 내용은 문제 해결을 참조하세요.

anthos-gke aws management diagnose snapshot
           --ssh-key-path PATH \
           [--bastion-ip IP] \
           [--bastion-ssh-key-path PATH] \
           [--cluster-ssh-key-path PATH] \
           [--dry-run] \
           [--mgmt-service-ssh-key-path PATH] \
           [--nodepool-ssh-key-path PATH] \
           [--output PATH] \
           [--snapshot-config PATH] \
           [--workspace DIRECTORY] \
           [--quiet]

플래그

--ssh-key-path PATH

SSH 키 파일의 경로를 제공하는 필수 인수입니다. 대부분의 사용자는 이 값이 ~/.ssh/anthos-gke여야 합니다.

선택적 플래그

[--bastion-ip IP]

배스천 호스트 IP 주소를 지정합니다.

[--bastion-ssh-key-path PATH]

배스천 호스트의 SSH 키 파일 경로입니다. 기본값은 --ssh-key-path입니다.

[--cluster-ssh-key-path PATH]

워크로드 클러스터 컨트롤 플레인 머신의 SSH 키 파일 경로입니다. 기본값은 --ssh-key-path입니다.

[--dry-run]

지원 번들을 생성하지 않고 스냅샷 구성 파일을 표시하는 옵션입니다.

[--mgmt-service-ssh-key-path PATH]

관리 서비스의 SSH 키 파일 경로입니다. 기본값은 --ssh-key-path입니다.

[--nodepool-ssh-key-path PATH]

노드 풀 머신의 SSH 키 파일 경로입니다. 기본값은 --ssh-key-path입니다.

[--snapshot-config PATH]

YAML 스냅샷 구성 파일의 경로입니다(선택사항).

[--output PATH]

anthos-gke가 지원 번들 파일을 만드는 경로입니다.

--workspace DIRECTORY

anthos-gke.yaml 파일이 포함된 디렉터리의 선택적 인수입니다. 기본값은 현재 디렉터리입니다.

[--quiet]

Console에 인쇄된 메시지를 삭제합니다.

예

~/example/workspace 디렉터리에 정의된 관리 서비스의 지원 번들을 생성하려면 다음 명령어를 실행합니다.

anthos-gke aws management diagnose snapshot \
             --ssh-key-path ~/.ssh/anthos-gke \
             --workspace ~/example/workspace

기본 스냅샷 구성을 보려면 다음 명령어를 실행합니다.

anthos-gke aws management diagnose snapshot \
             --ssh-key-path ~/.ssh/anthos-gke \
             --dry-run

자체 bash 및 kubectl 명령어를 포함하여 커스텀 스냅샷 구성 파일을 지정하려면 다음 명령어를 실행합니다.

anthos-gke aws management diagnose snapshot \
             --ssh-key-path ~/.ssh/anthos-gke
             --snapshot-config ~/my-snapshot-config.yaml

삭제

anthos-gke aws management delete 명령어는 관리 클러스터를 삭제합니다.

경고: 이 명령어를 실행하려면 모든 사용자 클러스터와 외부 부하 분산기 또는 사용자 클러스터와 연결된 영구 디스크 볼륨을 삭제해야 합니다. anthos-gke aws management delete를 실행하기 전에 이러한 리소스를 삭제합니다.

anthos-gke aws management delete DIRECTORY

선택적 플래그

[--force]

사용자가 관리 서비스에 연결할 수 없는 경우에도 관리 서비스가 강제로 삭제됩니다.

위치 인수

DIRECTORY

anthos-gke.yaml 파일이 포함된 디렉터리의 선택적 인수입니다. 기본값은 현재 디렉터리입니다.

예

현재 작업 디렉터리에 정의된 관리 서비스를 삭제하려면 다음 명령어를 실행합니다.

anthos-gke aws management delete

특정 디렉터리에 정의된 관리 서비스를 삭제하려면 다음 명령어를 실행합니다.

anthos-gke aws management delete ~/example/workspace