Halaman ini menjelaskan penginstalan dan penyiapan gsutil, yakni alat yang dapat digunakan untuk mengakses Cloud Storage dari command line menggunakan HTTPS.
Cukup dengan menginstal gsutil akan memberi Anda akses baca dan/atau tulis langsung ke data publik. Mengautentikasi ke layanan Cloud Storage memberi Anda akses baca dan/atau tulis ke data yang dilindungi yang telah dibagikan kepada Anda. 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.0 dan yang lebih baru memerlukan Python 3.
Jika berencana menggunakan objek gabungan, Anda harus menginstal crcmod yang dikompilasi. Di Windows, ini hanya tersedia untuk Python 32-bit. Untuk informasi lebih lanjut tentang crcmod, instal gsutil dan lihat topik bantuan dengan menggunakan perintah
gsutil help crc32c
.
Menginstal gsutil
Metode penginstalan dan update yang didukung secara resmi untuk gsutil adalah bagian dari Google Cloud CLI.
Menginstal gsutil sebagai bagian dari Google Cloud CLI
Ikuti petunjuk untuk sistem operasi Anda guna menginstal gsutil sebagai bagian dari Google Cloud CLI:
- Pastikan Anda memiliki versi Python yang didukung. Google Cloud CLI memerlukan Python 3.8 hingga 3.12. Perhatikan bahwa paket Linux x86_64 menyertakan
paket penafsir Python yang akan dipilih secara default. Untuk
mengetahui informasi cara memilih dan mengonfigurasi penafsir Python Anda, lihat
gcloud topic startup
. - Download salah satu opsi berikut:
Platform Nama paket Ukuran SHA256 Checksum Linux 64 bit (x86_64)
google-cloud-cli-472.0.0-linux-x86_64.tar.gz 202,1 MB f80fea5087bc82b2c4d3aefee8112c25163f44dc47773529eb5e46b0001c8b8f Linux 64 bit (Arm)
google-cloud-cli-472.0.0-linux-arm.tar.gz 119,0 MB f024989b5080f00ab711039c7595a7d9195cc873a89d4f50575afff8a3d9415d Linux 32 bit (x86)
google-cloud-cli-472.0.0-linux-x86.tar.gz 117,1 MB 676af5fdb89427c91665face39c9c25ae02860453350525ef12f96bf8ce819f2 Untuk mendownload file arsip Linux, jalankan perintah berikut:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-472.0.0-linux-x86_64.tar.gz
Lihat tabel di atas dan ganti google-cloud-cli-472.0.0-linux-x86_64.tar.gz dengan nama paket
*.tar.gz
yang berlaku untuk konfigurasi Anda. - Untuk mengekstrak isi file ke sistem file Anda (sebaiknya ke direktori utama Anda), jalankan perintah berikut:
Opsional: Untuk mengganti penginstalan yang ada, hapus direktoritar -xf google-cloud-cli-472.0.0-linux-x86_64.tar.gz
google-cloud-sdk
yang ada, lalu ekstrak arsip ke lokasi yang sama. - Tambahkan gcloud CLI ke jalur Anda. Jalankan skrip penginstalan dari root folder yang Anda ekstrak menggunakan perintah berikut:
Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dan dengan memberikan preferensi sebagai tanda. Untuk melihat flag yang tersedia, jalankan:./google-cloud-sdk/install.sh
Opsional:./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 pelengkapan perintah, jawabY
saat diminta.
- Untuk mengirim statistik penggunaan anonim guna membantu meningkatkan gcloud CLI, jawab
- Buka terminal baru agar perubahan diterapkan.
- Untuk melakukan inisialisasi gcloud CLI, jalankan
gcloud init
: - Opsional: Instal komponen tambahan menggunakan pengelola komponen.
./google-cloud-sdk/bin/gcloud init
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 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
dancurl
:sudo apt-get install apt-transport-https ca-certificates gnupg curl
- Impor kunci publik Google Cloud.
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.
- 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 bertanda tangan, 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
- Untuk distribusi yang lebih baru (Debian 9+ atau Ubuntu 18.04+), jalankan perintah berikut:
- Update dan instal gcloud CLI:
Untuk opsisudo apt-get update && sudo apt-get install google-cloud-cli
apt-get
tambahan, seperti menonaktifkan dialog atau uji coba, lihat halaman utamaapt-get
.Tips Docker: Jika menginstal gcloud CLI di dalam image Docker, gunakan satu langkah RUN saja:
Untuk image dasar lama yang tidak mendukung perintahRUN 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 | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
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
- (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
- 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
Isi paket
Gcloud CLI tersedia dalam format paket untuk penginstalan pada sistem Red Hat Enterprise Linux 7, 8, dan 9; Fedora 33 dan 34; 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.
- Memperbarui DNF dengan informasi repositori gcloud CLI.
Contoh perintah berikut ditujukan untuk penginstalan yang kompatibel dengan Red Hat Enterprise Linux 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
-
Jika Anda menginstal di Fedora 34 atau 35, instal
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Instal gcloud CLI:
sudo dnf install google-cloud-cli
- (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
- Jalankan
gcloud init
untuk memulai:gcloud init
Mendowngrade versi gcloud CLI
Jika Anda ingin kembali ke versi gcloud CLI tertentu, dengan VERSION
dalam bentuk 123.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
-
Pastikan Anda memiliki versi Python yang didukung:
-
Untuk memeriksa versi Python Anda saat ini, jalankan
python3 -V
ataupython -V
. Versi yang didukung adalah Python 3.8 hingga 3.12. - Skrip penginstalan utama menawarkan untuk menginstal Python 3.11.
- Jika tidak, untuk menginstal versi Python yang didukung, kunjungi Python Releases for macOS Python.org.
- Jika ada beberapa penafsir Python yang terinstal di komputer Anda, setel variabel lingkungan CLOUDSDK_PYTHON dalam shell agar mengarah ke jalur penafsir pilihan Anda.
-
Untuk mengetahui informasi selengkapnya tentang cara memilih dan mengonfigurasi penafsir Python Anda, lihat
gcloud topic startup
.
-
Untuk memeriksa versi Python Anda saat ini, jalankan
- Download salah satu opsi berikut:
-
Ekstrak arsip ke lokasi mana pun pada sistem file Anda (sebaiknya direktori Home). Di macOS, hal ini dapat dilakukan dengan membuka file arsip
.tar.gz
yang didownload di lokasi yang diinginkan.Untuk mengganti penginstalan yang ada, hapus direktori
google-cloud-sdk
yang ada, lalu ekstrak arsip ke lokasi yang sama. -
(Opsional) Gunakan skrip penginstalan untuk menambahkan alat gcloud CLI ke
PATH
.Anda juga dapat memilih untuk mengaktifkan pelengkapan perintah untuk shell, kumpulan statistik penggunaan, dan menginstal Python 3.11.Jalankan skrip (dari root folder yang Anda ekstrak pada langkah terakhir) menggunakan perintah ini:
Hal ini juga dapat dilakukan secara noninteraktif (misalnya, menggunakan skrip) dengan memberikan preferensi sebagai tanda. Untuk mendeskripsikan flag yang tersedia, jalankan:./google-cloud-sdk/install.sh
Untuk menjalankan skrip penginstalan dengan mode pembaca layar aktif:./google-cloud-sdk/install.sh --help
Buka terminal baru agar perubahan diterapkan../google-cloud-sdk/install.sh --screen-reader=true
-
Untuk melakukan inisialisasi gcloud CLI, jalankan
gcloud init
: - Opsional. Instal komponen tambahan menggunakan pengelola komponen.
Platform | Paket | Ukuran | SHA256 Checksum |
---|---|---|---|
macOS 64-bit
(x86_64) |
google-cloud-cli-472.0.0-darwin-x86_64.tar.gz | 124,8 MB | cc9d313ed286aae4f4a28b57897bde46199122295cd44109461b2ab0ecc94d59 |
macOS 64-bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-472.0.0-darwin-arm.tar.gz | 121,9 MB | bd13287a300d4e2c220a49be56008ae67147ab2b263eb61806d80016762bb583 |
macOS 32-bit
(x86) |
google-cloud-cli-472.0.0-darwin-x86.tar.gz | 123,5 MB | 5ca87cb1a9fff1ccb9da488451e6bd50d2eb295db3fc6d4aa5d39d3f41d8b0ff |
./google-cloud-sdk/bin/gcloud init
-
Google Cloud CLI dapat digunakan di Windows 8.1 dan yang lebih baru, serta Windows Server 2012 dan yang lebih baru.
-
Download penginstal Google Cloud CLI.
Atau, buka terminal PowerShell dan jalankan perintah PowerShell berikut:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
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. -
Google Cloud CLI memerlukan Python; versi yang didukung adalah Python 3.8 hingga 3.12. 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. 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
.- 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.
- Jika penginstalan Anda tidak berhasil karena perintah
find
tidak dikenali, pastikan variabel lingkunganPATH
Anda ditetapkan untuk menyertakan folder yang berisifind
. Biasanya, ini adalahC:\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.
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 (autentikasi). 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. Perlu diperhatikan bahwa Anda mungkin sudah melakukan penyiapan ini jika mengikuti langkah-langkah penginstalan di atas. 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
storage.mtls.googleapis.com
. 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":
-
use_client_certificate
: Flag yang mengontrol apakah mTLS akan digunakan atau tidak. -
cert_provider_command
: Perintah shell yang mencetak sertifikat ke stdout agar dapat dibaca oleh gsutil.
Cobalah sendiri
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Storage dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Coba Cloud Storage gratis