Instal gsutil

Halaman ini menjelaskan penginstalan dan penyiapan gsutil, yakni alat yang memungkinkan Anda mengakses Cloud Storage dari command line menggunakan HTTPS.

Dengan menginstal gsutil, Anda akan langsung mendapatkan akses ke data publik, sehingga Anda dapat membaca dan menulis sesuai izin yang diberikan. Untuk berinteraksi dengan data yang dilindungi yang dibagikan kepada Anda, autentikasi dengan layanan Cloud Storage diperlukan. Dengan mengaktifkan penagihan, Anda dapat membuat dan mengelola bucket Anda sendiri.

Persyaratan sistem

  • Alat gsutil dapat berjalan di Linux/Unix, Mac OS, dan Windows (XP atau yang lebih baru).

  • gsutil versi 5.35 atau yang lebih baru memerlukan Python 3.9 hingga 3.13, yang dapat Anda peroleh dengan menggunakan pengelola versi Python atau dengan menginstal versi yang sesuai.

Petunjuk berikut menunjukkan cara mengelola versi Python:

Linux

Prasyarat: Instal pengelola versi Python (pyenv) dan instal versi Python yang sesuai.

  1. Menetapkan Versi Python Global:
    • Untuk menetapkan Python 3.13 sebagai versi global: 
      pyenv global 3.13
    • Atau, tetapkan versi Python secara lokal untuk folder project tertentu: 
      pyenv local 3.13
  2. Pastikan versi Python yang benar sedang digunakan: 
    python --version

    Anda akan melihat:

    Python 3.13
macOS

Metode 1: Menggunakan Homebrew (brew)

Prasyarat: Instal Homebrew dan instal versi Python yang sesuai melalui Homebrew.

  1. Tetapkan versi Python tertentu sebagai default:
    • Tambahkan versi yang Anda inginkan ke $PATH. Misalnya, untuk menggunakan Python 3.13: 
      export PATH="/usr/local/opt/python@3.13/bin:$PATH"
    • Untuk membuat perubahan ini permanen, tambahkan jalur ke file konfigurasi shell Anda (~/.bash_profile, ~/.zshrc, atau ~/.bashrc).
  2. Pastikan versi Python yang benar sedang digunakan: 
    python --version

    Anda akan melihat:

    Python 3.13

Metode 2: Menggunakan pyenv

Prasyarat: Instal pengelola versi Python (pyenv) dan instal versi python yang sesuai melalui pyenv.

  1. Tetapkan versi Python global:
    • Untuk menetapkan versi Python secara global (untuk semua terminal): 
      pyenv global 3.13
    • Atau, tetapkan versi Python secara lokal untuk folder project tertentu: 
      pyenv local 3.13
  2. Pastikan versi Python yang benar sedang digunakan: 
    python --version

    Anda akan melihat:

    Python 3.13
Windows

Prasyarat: Instal pengelola versi Python (pyenv-win) dan instal versi Python yang sesuai melalui pyenv.

  1. Menetapkan Versi Python Global:
    • Untuk menetapkan Python 3.13 sebagai versi global: 
      pyenv global 3.13
    • Atau, tetapkan versi Python secara lokal untuk folder project tertentu: 
      pyenv local 3.13
  2. Pastikan versi Python yang benar sedang digunakan: 
    python --version

    Anda akan melihat:

    Python 3.13
  • Jika berencana menggunakan objek gabungan, Anda harus menginstal crcmod yang dikompilasi. Di Windows, ini hanya tersedia untuk Python 32-bit. Untuk mengetahui informasi selengkapnya tentang crcmod, instal gsutil dan lihat topik bantuan menggunakan perintah gsutil help crc32c.

Menginstal gsutil

Metode penginstalan dan update yang didukung secara resmi untuk gsutil adalah bagian dari Google Cloud CLI.

Sebelum memulai

Google Cloud CLI dan gsutil memiliki dependensi versi Python yang dapat menyebabkan masalah kompatibilitas. Google Cloud CLI memerlukan Python 3.9 hingga 3.14, sedangkan gsutil memerlukan Python 3.9 hingga 3.13.

Untuk menginstal gsutil, sebaiknya instal sebagai bagian dari Google Cloud CLI. Jika Anda memilih untuk menginstal gsutil secara langsung, gunakan Python 3.9 hingga 3.13 untuk menghindari masalah kompatibilitas.

Menginstal gsutil sebagai bagian dari Google Cloud CLI

Ikuti petunjuk untuk sistem operasi Anda guna menginstal gsutil sebagai bagian dari Google Cloud CLI:

Linux
  1. Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.9 hingga 3.14. Perhatikan, paket Linux x86_64 menyertakan penafsir Python yang dipaketkan yang akan dipilih secara default. Untuk mengetahui informasi cara memilih dan mengonfigurasi penafsir Python Anda, lihat gcloud topic startup.
  2. Download salah satu opsi berikut:
    Platform Nama paket Ukuran SHA256 Checksum
    Linux 64 bit

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 150,5 MB 31000673c1f9e18ec7b38823748031c58949cb0479d36ede999ae8cad6097ae3
    Linux 64 bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 57,1 MB a1c1a88274e8bf11561771b9373b566cbb044f1cb3884e454625ec9449ea33f2
    Linux 32 bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 57,1 MB 32ff2bea65cd5c79aa86b948219c1e861a0434cc99011f4d977c4a9810e595de

    Untuk mendownload file arsip Linux, jalankan perintah berikut: 

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/google-cloud-cli-linux-x86_64.tar.gz

    Lihat tabel di atas dan ganti google-cloud-cli-linux-x86_64.tar.gz dengan nama paket *.tar.gz yang berlaku untuk konfigurasi Anda.

  3. Untuk mengekstrak konten file ke sistem file Anda (sebaiknya ke direktori home Anda), jalankan perintah berikut: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Opsional: Untuk mengganti penginstalan yang ada, hapus direktori google-cloud-sdk yang ada, lalu ekstrak arsip ke lokasi yang sama.
  4. (Opsional) Tambahkan gcloud CLI ke PATH Anda. Anda juga dapat memilih untuk melakukan pelengkapan perintah untuk shell dan pengumpulan statistik penggunaan. Jalankan skrip penginstalan (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah berikut: 
    ./google-cloud-sdk/install.sh
     Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dan dengan memberikan preferensi sebagai flag. Untuk melihat flag yang tersedia, jalankan: 
    ./google-cloud-sdk/install.sh --help
    • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
    • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan penyelesaian perintah, jawab Y saat diminta.
  5. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
  6. Opsional: Instal komponen tambahan menggunakan pengelola komponen.
Debian/Ubuntu

Isi paket

Gcloud CLI tersedia dalam format paket untuk diinstal di sistem Debian dan Ubuntu. Paket ini hanya berisi perintah gcloud, gcloud alpha, gcloud beta, gsutil, dan bq. Versi ini tidak menyertakan ekstensi kubectl atau App Engine yang diperlukan untuk men-deploy aplikasi menggunakan perintah gcloud. Jika menginginkan komponen ini, Anda harus menginstalnya secara terpisah.

Sebelum memulai

Sebelum menginstal gcloud CLI, pastikan sistem operasi Anda memenuhi persyaratan berikut:

  • Ini adalah rilis Ubuntu yang belum mencapai akhir siklus proses atau rilis stabil Debian yang belum mencapai akhir masa pakai
  • Baru-baru ini, paket-paketnya telah diperbarui: 
    sudo apt-get update
  • Library ini telah menginstal apt-transport-https dan curl: 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl
Penginstalan
  1. Impor kunci publik Cloud de Confiance by S3NS .

    • Untuk distribusi yang lebih baru (Debian 9+ atau Ubuntu 18.04+), jalankan perintah berikut:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • Untuk distribusi yang lebih lama, jalankan perintah berikut: 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    • Jika perintah apt-key distribusi Anda tidak mendukung argumen --keyring, jalankan perintah berikut:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • Jika Anda tidak bisa mendapatkan update terbaru karena kunci yang sudah tidak berlaku, dapatkan file kunci apt-get.gpg terbaru.

  2. Tambahkan URI distribusi gcloud CLI sebagai sumber paket.
    • Untuk distribusi yang lebih baru (Debian 9+ atau Ubuntu 18.04+), jalankan perintah berikut: 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    • Untuk distribusi lama yang tidak mendukung opsi ditandatangani oleh, jalankan perintah berikut:

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. Update dan instal gcloud CLI: 
    sudo apt-get update && sudo apt-get install google-cloud-cli
     Untuk opsi apt-get tambahan, seperti menonaktifkan dialog atau uji coba, lihat halaman utama apt-get.

    Tips Docker: Jika menginstal gcloud CLI di dalam image Docker, gunakan satu langkah RUN saja:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    Untuk gambar dasar lama yang tidak mendukung perintah gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
  4. (Opsional) Instal salah satu komponen tambahan berikut:
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

    Misalnya, komponen google-cloud-cli-app-engine-java dapat diinstal sebagai berikut: 

    sudo apt-get install google-cloud-cli-app-engine-java
  5. Jalankan gcloud init untuk memulai: 
    gcloud init

Mendowngrade versi gcloud CLI

Untuk kembali ke versi gcloud CLI tertentu, jalankan perintah berikut dengan VERSION dalam bentuk 123.0.0:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Sepuluh rilis terbaru selalu tersedia di repo.

CATATAN: Untuk rilis sebelum 371.0.0, nama paketnya adalah google-cloud-sdk

Red Hat/Fedora/CentOS

Isi paket

Gcloud CLI tersedia dalam format paket untuk diinstal di sistem Red Hat Enterprise Linux 7, 8, dan 9; Fedora 41 dan 42; serta CentOS 7 dan 8. Paket ini hanya berisi perintah gcloud, gcloud alpha, gcloud beta, gsutil, dan bq. Ini tidak mencakup ekstensi kubectl atau App Engine yang diperlukan untuk men-deploy aplikasi menggunakan perintah gcloud, yang dapat diinstal secara terpisah, seperti yang akan dijelaskan nanti di bagian ini.

Penginstalan
  1. Update DNF dengan informasi repositori gcloud CLI.

    • Contoh perintah berikut ditujukan untuk penginstalan yang kompatibel dengan Red Hat Enterprise Linux 7, 8, atau 9, tetapi pastikan Anda memperbarui setelan sesuai kebutuhan untuk konfigurasi Anda:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • Untuk penginstalan yang kompatibel dengan RHEL 10, gunakan perintah berikut dengan gpgkey yang diperbarui:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM
  2. Instal libxcrypt-compat.x86_64. 
    sudo dnf install libxcrypt-compat.x86_64
  3. Instal gcloud CLI: 
    sudo dnf install google-cloud-cli
  4. (Opsional) Instal salah satu komponen tambahan berikut:
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

    Misalnya, komponen google-cloud-cli-app-engine-java dapat diinstal sebagai berikut: 

    sudo dnf install google-cloud-cli-app-engine-java
  5. Jalankan gcloud init untuk memulai: 
    gcloud init

Mendowngrade versi gcloud CLI

Jika Anda ingin kembali ke versi gcloud CLI tertentu, dan VERSION adalah bentuk123.0.0, jalankan: sudo dnf downgrade google-cloud-cli-VERSION Sepuluh rilis terbaru akan selalu tersedia di repositori. CATATAN: Untuk rilis sebelum 371.0.0, nama paketnya adalah google-cloud-sdk

macOS
  1. Pastikan Anda memiliki versi Python yang didukung:
    • Untuk memeriksa versi Python Anda saat ini, jalankan python3 -V atau python -V. Versi yang didukung adalah Python 3.9 hingga 3.14.
    • Skrip penginstalan utama menawarkan penginstalan Python 3.12 CPython.
      • Alat Command Line Xcode diperlukan untuk menginstal Python.
      • Pastikan Alat Command Line Xcode sudah diinstal dengan menjalankan: xcode-select -p.
      • Jika Alat Command Line Xcode tidak diinstal, instal dengan menjalankan: sudo xcode-select --install.
    • Atau, untuk menginstal versi Python yang didukung, buka Rilis Python untuk macOS di Python.org.
    • Jika Anda telah menginstal beberapa penafsir Python di komputer, tetapkan variabel lingkungan CLOUDSDK_PYTHON dalam shell Anda untuk mengarah ke jalur penafsir pilihan Anda.
    • Untuk mengetahui informasi selengkapnya tentang cara memilih dan mengonfigurasi penafsir Python Anda, lihat gcloud topic startup.
  2. Download salah satu opsi berikut:

    3. Platform Paket Ukuran SHA256 Checksum
    macOS 64-bit

    (x86_64)

    		 google-cloud-cli-darwin-x86_64.tar.gz 57,2 MB b24a11aa4f1816bff3122b3560c909c1eb7109bf8979821251d8bc5679582f10
    macOS 64-bit

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 57,1 MB b4d2b8b63593ad226cf1c4da0667ffa4a9cb923bd41ec269e67891491aeb126a
    macOS 32-bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 55,7 MB 6e66bdc92029fd3a3856e6a9bc03f2799079184ff3fe436c7ade1ef1a8f03452
  3. Ekstrak arsip ke lokasi mana pun pada sistem file Anda (sebaiknya direktori Home Anda). Di macOS, hal ini dapat dilakukan dengan membuka file arsip .tar.gz yang didownload di lokasi yang diinginkan. Atau jalankan perintah berikut: 
    tar -xf google-cloud-cli-darwin-arm.tar.gz

    Opsional: Untuk mengganti penginstalan yang ada, hapus direktori google-cloud-sdk yang ada, lalu ekstrak arsip ke lokasi yang sama.

  4. Jalankan skrip penginstalan (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah berikut: 
    ./google-cloud-sdk/install.sh

    Skrip akan meminta untuk menginstal Python 3.12 dan modul tertentu yang direkomendasikan.

    Penginstalan juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dengan memberikan preferensi sebagai flag. Untuk mendeskripsikan flag yang tersedia, jalankan: 
    ./google-cloud-sdk/install.sh --help
     Untuk menjalankan skrip penginstalan dengan mode pembaca layar aktif: 
    ./google-cloud-sdk/install.sh --screen-reader=true
     Opsional:
    • Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab Y saat diminta.
    • Untuk menambahkan gcloud CLI ke PATH dan mengaktifkan penyelesaian perintah, jawab Y saat diminta.
  5. Jika Anda memperbarui PATH di langkah sebelumnya, buka terminal baru agar perubahan diterapkan.
  6. Opsional. Instal komponen tambahan menggunakan pengelola komponen.
Windows
    Google Cloud CLI dapat digunakan di Windows 8.1 dan yang lebih baru, serta Windows Server 2012 dan yang lebih baru.

  1. Download penginstal Google Cloud CLI.

    Atau, buka terminal PowerShell dan jalankan perintah PowerShell berikut: 

    (New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

  2. Luncurkan penginstal dan ikuti petunjuknya. Penginstal ditandatangani oleh Google LLC.

    Jika Anda menggunakan pembaca layar, centang kotak Aktifkan mode pembaca layar. Opsi ini mengonfigurasi gcloud untuk menggunakan pelacak status, bukan indikator lingkaran berputar unicode, serta menampilkan progres sebagai persentase, dan meratakan tabel. Untuk mengetahui informasi selengkapnya, lihat Panduan fitur aksesibilitas.

  3. Google Cloud CLI memerlukan Python; versi yang didukung adalah Python 3.9 hingga 3.14. Secara default, Google Cloud CLI versi Windows dilengkapi dengan Python 3. Untuk menggunakan Google Cloud CLI, sistem operasi Anda harus dapat menjalankan versi Python yang didukung.

    Penginstal menginstal semua dependensi yang diperlukan, termasuk versi Python yang diperlukan. Meskipun Google Cloud CLI menginstal dan mengelola Python 3 secara default, Anda dapat menggunakan penginstalan Python yang sudah ada jika diperlukan dengan menghapus centang opsi untuk Menginstal Python yang Dipaketkan. Lihat gcloud topic startup untuk mempelajari cara menggunakan penginstalan Python yang sudah ada.

  4. Setelah penginstalan selesai, penginstal akan memberi Anda opsi untuk membuat Menu Mulai dan pintasan Desktop, memulai shell Google Cloud CLI, dan mengonfigurasi gcloud CLI. Pastikan Anda membiarkan opsi untuk memulai shell dan mengonfigurasi penginstalan telah dipilih. Penginstal memulai jendela terminal dan menjalankan perintah gcloud init.

  5. Penginstalan default tidak menyertakan ekstensi App Engine yang diperlukan untuk men-deploy aplikasi menggunakan perintah gcloud. Komponen ini dapat diinstal menggunakan pengelola komponen gcloud CLI.
Tips pemecahan masalah:
  • Jika penginstalan Anda tidak berhasil karena perintah find tidak dikenali, pastikan variabel lingkungan PATH Anda ditetapkan untuk menyertakan folder yang berisi find. Biasanya, ini adalah C:\WINDOWS\system32;.
  • Jika gcloud CLI di-uninstal, Anda harus memulai ulang sistem sebelum menginstal gcloud CLI lagi.
  • Jika proses ekstrak gagal, jalankan penginstal sebagai administrator.

Sebagai bagian dari penginstalan gsutil, Anda harus menetapkan variabel lingkungan CLOUDSDK_PYTHON untuk menggunakan versi Python yang benar. Untuk mengetahui detail selengkapnya, lihat gcloud startup topic.

Lakukan update dengan perintah components update: gcloud components update.

Menyiapkan Kredensial untuk Mengakses Data yang Dilindungi

Untuk mengakses data yang dilindungi atau menulis ke bucket yang dilindungi, Anda perlu menyiapkan kredensial (mengautentikasi). Misalnya, jika orang lain telah membuat akun Cloud Storage dan mengupload data yang hanya dapat diakses oleh Anda atau orang tertentu lainnya, Anda harus menyiapkan kredensial Anda ke layanan Cloud Storage agar dapat mengakses data ini.

Saat menggunakan gsutil sebagai bagian dari Google Cloud CLI, OAuth2 digunakan untuk mengautentikasi dan mengizinkan akses ke resource Cloud Storage Anda. Untuk mendapatkan akses, jalankan perintah gcloud init dan ikuti petunjuk yang diberikan dalam command line, yang mencakup login ke akun pengguna Anda. Perhatikan bahwa Anda mungkin sudah melakukan penyiapan ini jika mengikuti langkah-langkah penginstalan. Jika sebelumnya Anda menjalankan gcloud init, saat menjalankan perintah lagi, Anda akan ditanya apakah ingin menginisialisasi ulang konfigurasi atau membuat konfigurasi baru. Untuk mengetahui informasi selengkapnya, baca bagian Melakukan inisialisasi Google Cloud CLI.

Itu saja. Anda bsiap mengakses data yang dilindungi. Untuk melihat listingan perintah gsutil, ketik gsutil di command prompt.

Pemecahan masalah

Jika Anda mencoba mengautentikasi gsutil menggunakan perintah gcloud init, namun masih tidak dapat mengakses bucket atau objek yang diharapkan, sistem Anda mungkin memiliki versi gsutil lama yang berdiri sendiri serta versi gsutil yang terinstal dari Google Cloud CLI. Jalankan perintah gsutil version -l dan periksa nilai untuk using cloud sdk. Jika False, sistem Anda menggunakan versi gsutil mandiri saat menjalankan perintah. Sebaiknya hapus versi gsutil mandiri dari sistem Anda; namun, Anda dapat mengautentikasi menggunakan gsutil config -a atau gsutil config -e.

Mengautentikasi dengan HMAC

Meskipun OAuth 2.0 adalah cara yang direkomendasikan untuk mengautentikasi gsutil, Anda juga dapat menggunakan kunci HMAC untuk kredensial Anda. Untuk mengautentikasi dengan HMAC, gunakan perintah berikut: 

gsutil config -a

Dengan perintah ini, Anda akan diarahkan melalui proses autentikasi yang meminta ID akses dan secret yang terkait dengan kunci HMAC Anda.

Saat mengautentikasi dengan kunci HMAC, Anda harus menonaktifkan penerusan kredensial dari Google Cloud CLI menggunakan perintah: gcloud config set pass_credentials_to_gsutil false.

Aktifkan mTLS

Anda mungkin juga ingin mengaktifkan TLS bersama (mTLS). Jika mTLS diaktifkan di perangkat, perangkat Anda akan mencoba terhubung ke endpoint permintaan mTLS untuk JSON API. Sebelum koneksi diizinkan, Cloud Storage akan memverifikasi sertifikat di perangkat Anda.

Cara termudah untuk mendapatkan sertifikat adalah melalui Google Cloud CLI. Anda dapat menetapkannya secara manual di file .boto dengan menetapkan nilai berikut di bagian "Kredensial":

  1. use_client_certificate: Flag yang mengontrol apakah mTLS akan digunakan atau tidak.
  2. cert_provider_command: Perintah shell yang mencetak sertifikat ke stdout agar dapat dibaca oleh gsutil.