The product described by this documentation, Anthos Clusters on AWS (previous generation), is now in maintenance mode. All new installs must use the current generation product, Anthos clusters on AWS.

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 파일이 포함된 디렉터리로 바꿉니다.

신청

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 DIRECTORY

선택적 플래그

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

위치 인수

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

예

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

anthos-gke aws management delete

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

anthos-gke aws management delete ~/example/workspace