이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google Cloud CLI 설치 프로그램 사용

Google Cloud CLI는 지원되는 플랫폼별로 설치 프로그램을 제공하며 대화형 또는 비대화형으로 배포할 수 있습니다.

대화형 설치

설치 프로그램을 사용하면 대화형 모드로 최신 버전의 Google Cloud CLI를 다운로드, 설치, 설정할 수 있습니다. 설치 프로그램을 실행하면 Google Cloud CLI 구성요소가 다운로드되고 로컬 시스템에 설치됩니다. 또한 gcloud CLI 구성요소를 PATH에 추가하고 셸에서 명령어 완성 기능을 사용 설정하는 것과 같은 추가적인 설정 작업을 수행합니다.

Linux 및 macOS

명령줄에서 다음 명령어를 실행합니다.
```
curl https://sdk.cloud.google.com | bash
```
메시지가 표시되면 파일 시스템에서 위치(일반적으로 홈 디렉터리)를 선택하여 google-cloud-sdk 하위 디렉터리를 만듭니다.
gcloud CLI 개선을 위해 익명 사용 통계를 보내려면 메시지가 표시될 때 Y로 응답합니다.
PATH에 gcloud CLI 명령줄 도구를 추가하고 명령어 완성을 사용 설정하려면 메시지가 표시될 때 Y로 답합니다.
셸을 다시 시작합니다.
```
exec -l $SHELL
```
Google Cloud CLI 환경을 초기화하려면 gcloud init를 실행합니다.
```
gcloud init
```

Windows (설치 프로그램)

Google Cloud CLI 설치 프로그램을 다운로드합니다.

또는 PowerShell 터미널을 열고 다음 PowerShell 명령어를 실행합니다.

(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

설치 프로그램을 실행하고 안내 메시지를 따릅니다. 설치 프로그램 서명자는 Google LLC입니다.

스크린 리더를 사용하는 경우 스크린 리더 모드 설정 체크박스를 선택합니다. 이 옵션은 유니코드 스피너 대신 상태 추적기를 사용하고, 진행 상태를 백분율로 표시하고, 테이블을 평면화하도록 gcloud를 구성합니다. 자세한 내용은 가용성 기능 가이드를 참조하세요.
Google Cloud CLI에는 Python이 필요하며 지원되는 버전은 Python 3.9~3.13입니다. 기본적으로 Windows 버전의 Google Cloud CLI는 Python 3과 함께 제공됩니다. Google Cloud CLI를 사용하려면 운영체제에서 지원되는 Python 버전을 실행할 수 있어야 합니다.

설치 프로그램은 필요한 Python 버전을 포함하여 필요한 모든 종속 항목을 설치합니다. Google Cloud CLI는 기본적으로 Python 3을 설치 및 관리하지만 필요한 경우 번들 Python 설치 옵션을 선택 해제하여 기존 Python 설치를 사용할 수 있습니다. 기존 Python 설치를 사용하는 방법은 gcloud topic startup을 참조하세요.
설치가 완료되면 설치 프로그램에서 시작 메뉴 및 바탕화면 바로가기를 만들고, Google Cloud CLI 셸을 시작하고, gcloud CLI를 구성할 수 있는 옵션이 제공됩니다. 셸을 시작하고 설치를 구성하는 옵션은 선택한 상태로 두세요. 설치 프로그램이 터미널 창을 시작하고 gcloud init 명령어를 실행합니다.
기본 설치에는 gcloud 명령어를 사용하여 애플리케이션을 배포하는 데 필요한 App Engine 확장 프로그램이 포함되지 않습니다. 이러한 구성요소는 gcloud CLI 구성요소 관리자를 사용해서 설치할 수 있습니다.

문제 해결 팁:

find 명령어가 인식되지 않아 설치에 실패하는 경우 find가 들어 있는 폴더를 포함하도록 PATH 환경 변수가 설정되어 있는지 확인합니다. 일반적으로는, C:\WINDOWS\system32;입니다.
gcloud CLI를 제거한 후 gcloud CLI를 다시 설치하려면 먼저 시스템을 재부팅해야 합니다.
압축을 풀 수 없다면 설치 프로그램을 관리자로 실행합니다.

Windows (Zip)

다운로드한 .zip 파일에서 최신 버전을 설치할 수도 있습니다.

google-cloud-sdk.zip을 다운로드하고 콘텐츠의 압축을 풉니다. 다운로드한 파일을 마우스 오른쪽 버튼으로 클릭하고 압축 풀기를 선택하면 됩니다.
google-cloud-sdk\install.bat 스크립트를 시작하고 설치 프롬프트를 따릅니다.
설치가 완료되면 명령어 프롬프트(cmd.exe)를 다시 시작합니다.
gcloud init를 실행합니다.
```
C:\> gcloud init
```

비대화형(자동) 배포

설치 스크립트를 사용하여 Google Cloud CLI 설치를 자동화할 수 있습니다.

Linux 및 MacOS:

설치 스크립트를 bash에 파이핑하지 않고 로컬로 저장합니다.

명령 프롬프트에서 다음을 입력합니다.
```
curl https://sdk.cloud.google.com > install.sh
```
스크립트를 실행하여 다음과 같은 인수를 전달합니다.
```
bash install.sh --disable-prompts
```

install.sh 옵션은 다음과 같습니다.

--disable-prompts - 프롬프트를 사용 중지합니다.
--install-dir=DIRECTORY - 설치 루트 디렉터리를 DIRECTORY로 설정합니다. Google Cloud CLI가 DIRECTORY/google-cloud-sdk에 설치되어 있습니다. 기본값은 $HOME입니다.

Windows:

/S - 자동으로 설치합니다. 설치 프로그램 페이지가 표시되지 않습니다. 설치 설정을 변경하려면 플래그를 사용합니다.
/D - 기본 설치 디렉터리를 설정합니다. 명령줄에서 사용하는 마지막 매개변수여야 하며 경로에 공백이 포함된 경우에도 따옴표를 포함해서는 안 됩니다. 절대 경로만 지원됩니다(예: /D=C:\CloudSDK).
/allusers - 모든 사용자용으로 설치합니다.
/singleuser - 현재 사용자용으로 설치합니다(기본값).
/screenreader - 스크린 리더 모드를 설정합니다(기본값은 해제).
/reporting - 사용량 보고를 사용 설정합니다(기본값은 사용량 보고 중지).
/noreporting - 사용량 보고를 사용 중지합니다(기본값은 사용량 보고 중지).
/nostartmenu - 시작 메뉴 바로가기를 만들지 않습니다(기본값은 바로가기 만들기).
/nodesktop - 바탕화면 바로가기를 만들지 않습니다(기본값은 바로가기 만들기).

직접 사용해 보기

Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

무료로 시작하기