macOS 빠른 시작

이 페이지에서는 Google Cloud SDK를 설치하고 초기화한 후 명령줄에서 코어 gcloud 명령어를 실행하는 방법을 보여줍니다.

시작하기 전에

  1. 프로젝트가 없으면 Google Cloud Platform 프로젝트를 만듭니다.

  2. Cloud SDK에는 Python이 필요합니다. 지원되는 버전은 3.5~3.7 및 2.7.9 이상입니다. 시스템에 설치된 Python 버전을 확인하는 방법은 다음과 같습니다.

    python -V
    
  3. 운영체제에 가장 적합한 보관 파일을 다운로드합니다. 대부분의 머신은 64비트 패키지를 실행합니다.

    플랫폼 패키지 크기 SHA-256 체크섬
    macOS 64비트

    (x86_64)

    google-cloud-sdk-293.0.0-darwin-x86_64.tar.gz 70.3 MB d6a13d7cc0791c104ac2a1a1da1f676bcd7c6fc11d0f2079f60d866f1ded94b6
    macOS 32비트

    (x86)

    google-cloud-sdk-293.0.0-darwin-x86.tar.gz 68.3 MB 20715c1bd1feb0eb03285251b141952643e5dceccf5222268a7d239b6f55696e
  4. 파일 시스템의 임의 위치(예: 홈 디렉토리)에 보관 파일 압축을 풉니다. macOS에서는 다운로드된 .tar.gz 보관 파일을 원하는 위치에서 열어 압축을 풀 수 있습니다.

  5. 선택사항: 설치 스크립트를 사용하여 경로에 Cloud SDK 도구를 추가합니다. 설치 프로세스 중에 bash 셸과 사용 통계 수집에 명령어 완성을 선택할 수도 있습니다. 이 명령어를 사용하여 스크립트를 실행합니다.

    ./google-cloud-sdk/install.sh
    

    변경사항이 적용되도록 터미널을 다시 시작합니다.

    또는 전체 경로를 통해 실행 파일을 호출하여 다운로드한 보관 파일 압축을 푼 후에 Cloud SDK를 호출할 수 있습니다.

SDK 초기화

gcloud init 명령어를 사용하여 여러 가지 일반적인 SDK 설정 작업을 수행할 수 있습니다. 여기에는 SDK 도구가 사용자 계정 사용자 인증 정보를 사용하여 Google Cloud Platform에 액세스하도록 승인하고 기본 SDK 구성을 설정하는 작업이 포함됩니다.

SDK를 초기화하려면 다음을 따르세요.

  1. 명령 프롬프트에서 다음 명령어를 입력합니다.

    gcloud init
    

    참고: gcloud 명령어를 찾을 수 없다는 오류 메시지가 표시되면 위 섹션의 5단계를 참조하세요.

    참고: 명령어가 웹브라우저를 시작하지 못하도록 하려면 gcloud init --console-only를 사용하세요. 웹브라우저 없이 비대화형으로 승인하려면 Google Cloud Platform Console을 사용하여 적절한 범위의 서비스 계정을 만들고 해당 JSON 키 파일과 함께 gcloud auth activate-service-account를 사용합니다.

  2. Google 사용자 계정을 사용하여 로그인하는 옵션을 수락합니다.

    To continue, you must log in. Would you like to log in (Y/n)? Y
    
  3. 브라우저에 메시지가 표시되면 Google 사용자 계정에 로그인하고 허용을 클릭하여 Google Cloud Platform 리소스에 대한 액세스 권한을 부여합니다.

  4. 명령 프롬프트에서 소유자, 편집자 또는 뷰어 권한이 있는 프로젝트 목록의 Cloud Platform 프로젝트를 선택합니다.

    Pick cloud project to use:
     [1] [my-project-1]
     [2] [my-project-2]
     ...
     Please enter your numeric choice:
    

    프로젝트가 하나만 있는 경우 gcloud init가 프로젝트를 선택합니다.

  5. Google Compute Engine API를 사용 설정한 경우 gcloud init을 사용하여 기본 Compute Engine 영역을 선택할 수 있습니다.

    Which compute zone would you like to use as project default?
     [1] [asia-east1-a]
     [2] [asia-east1-b]
     ...
     [14] Do not use default zone
     Please enter your numeric choice:
    

    gcloud init은 설정 단계를 성공적으로 완료했음을 확인합니다.

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    
  6. (선택사항) 스크린 리더 환경을 더욱 간소화할 수 있도록 gcloud 명령줄 도구는 accessibility/screen_reader 속성과 함께 제공됩니다.

    이 속성을 사용하려면 다음을 실행합니다.

    gcloud config set accessibility/screen_reader true
    

    gcloud 명령줄 도구와 함께 제공되는 접근성 기능에 대한 자세한 내용은 접근성 기능 사용 설정 가이드를 참조하세요.

코어 gcloud 명령 실행

SDK 설치에 대한 정보를 보려면 gcloud 명령어를 실행합니다.

  1. 사용자 인증 정보가 로컬 시스템에 저장된 계정을 나열하려면 다음 명령어를 입력합니다.

    gcloud auth list
    

    gcloud는 인증된 계정 목록을 표시합니다.

           Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. 활성 SDK 구성 속성을 나열하려면 다음 명령어를 입력합니다.

    gcloud config list
    

    gcloud는 속성 목록을 표시합니다.

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. Cloud SDK 설치 및 활성 SDK 구성에 대한 정보를 보려면 다음 명령어를 입력합니다.

    gcloud info
    

    gcloud는 Cloud SDK 설치에 대한 요약 정보를 표시합니다. 여기에는 시스템, 설치된 SDK 구성요소, 활성 사용자 계정과 현재 프로젝트, 활성 SDK 구성의 속성이 포함됩니다.

  4. 명령줄에서 gcloud 명령어와 기타 항목에 대한 정보를 보려면 다음 명령어를 입력합니다.

    gcloud help
    

    예를 들어 gcloud compute instances create의 도움말을 보려면 다음 명령어를 입력합니다.

    gcloud help compute instances create
    

    gcloud는 명령어에 대한 설명, 명령어 플래그와 인수 목록, 사용 방법 예시를 포함한 도움말 항목을 표시합니다.

다음 단계

  • gcloud 도구 가이드에서 간략한 주요 개념 소개, 명령어 규칙, 유용한 팁 등 gcloud 명령줄 도구의 개요 읽기
  • gcloud 참조 가이드에서 Google Cloud Platform을 통해 다양한 작업을 수행하는 데 사용할 수 있는 설명, 플래그, 예시 등 각 gcloud 명령어의 세부정보 페이지 읽기
  • Cloud SDK 구성요소 관리자를 사용하여 App Engine 에뮬레이터 또는 kubectl 등의 추가 구성요소 설치