GSP1131

Ringkasan
Artifact Registry adalah layanan yang aman, skalabel, dan terkelola sepenuhnya untuk menyimpan, mengelola, dan mengamankan artefak dan dependensi build Anda. Anda akan mempelajari cara membuat repositori Docker pribadi, mengonfigurasi autentikasi, serta mengirim dan mengambil image Docker contoh. Pengalaman interaktif ini akan memberi Anda pemahaman dasar tentang cara menggunakan Artifact Registry untuk aplikasi dalam container.
Tujuan
Di lab ini, Anda akan mempelajari cara melakukan tugas berikut:
- Membuat repositori Docker pribadi di Artifact Registry
- Menyiapkan autentikasi
- Mengirim image ke repositori
- Mengambil image dari repositori
Prasyarat
Sebaiknya Anda telah berpengalaman menggunakan Docker sebelum menjalankan lab ini. Anda dapat membaca dokumentasi Docker untuk mengetahui informasi dasar atau informasi pengantar. Anda juga dapat melihat lab Pengantar Docker kami untuk praktik langsung lainnya.
Penyiapan dan persyaratan
Sebelum mengklik tombol Start Lab
Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer yang dimulai saat Anda mengklik Start Lab akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.
Lab interaktif ini dapat Anda gunakan untuk melakukan aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.
Untuk menyelesaikan lab ini, Anda memerlukan:
- Akses ke browser internet standar (disarankan browser Chrome).
Catatan: Gunakan jendela Samaran (direkomendasikan) atau browser pribadi untuk menjalankan lab ini. Hal ini akan mencegah konflik antara akun pribadi Anda dan akun siswa yang dapat menyebabkan tagihan ekstra pada akun pribadi Anda.
- Waktu untuk menyelesaikan lab. Ingat, setelah dimulai, lab tidak dapat dijeda.
Catatan: Hanya gunakan akun siswa untuk lab ini. Jika Anda menggunakan akun Google Cloud yang berbeda, Anda mungkin akan dikenai tagihan ke akun tersebut.
Cara memulai lab dan login ke Google Cloud Console
-
Klik tombol Start Lab. Jika Anda perlu membayar lab, dialog akan terbuka untuk memilih metode pembayaran.
Di sebelah kiri ada panel Lab Details yang berisi hal-hal berikut:
- Tombol Open Google Cloud console
- Waktu tersisa
- Kredensial sementara yang harus Anda gunakan untuk lab ini
- Informasi lain, jika diperlukan, untuk menyelesaikan lab ini
-
Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).
Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.
Tips: Atur tab di jendela terpisah secara berdampingan.
Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.
-
Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.
{{{user_0.username | "Username"}}}
Anda juga dapat menemukan Username di panel Lab Details.
-
Klik Next.
-
Salin Password di bawah dan tempel ke dialog Welcome.
{{{user_0.password | "Password"}}}
Anda juga dapat menemukan Password di panel Lab Details.
-
Klik Next.
Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda.
Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.
-
Klik halaman berikutnya:
- Setujui persyaratan dan ketentuan.
- Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
- Jangan mendaftar uji coba gratis.
Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.
Catatan: Untuk mengakses produk dan layanan Google Cloud, klik Navigation menu atau ketik nama layanan atau produk di kolom Search.
Mengaktifkan Cloud Shell
Cloud Shell adalah mesin virtual yang dilengkapi dengan berbagai alat pengembangan. Mesin virtual ini menawarkan direktori beranda persisten berkapasitas 5 GB dan berjalan di Google Cloud. Cloud Shell menyediakan akses command-line untuk resource Google Cloud Anda.
-
Klik Activate Cloud Shell
di bagian atas Konsol Google Cloud.
-
Klik jendela berikut:
- Lanjutkan melalui jendela informasi Cloud Shell.
- Beri otorisasi ke Cloud Shell untuk menggunakan kredensial Anda guna melakukan panggilan Google Cloud API.
Setelah terhubung, Anda sudah diautentikasi, dan project ditetapkan ke Project_ID, . Output berisi baris yang mendeklarasikan Project_ID untuk sesi ini:
Project Cloud Platform Anda dalam sesi ini disetel ke {{{project_0.project_id | "PROJECT_ID"}}}
gcloud adalah alat command line untuk Google Cloud. Alat ini sudah terinstal di Cloud Shell dan mendukung pelengkapan command line.
- (Opsional) Anda dapat menampilkan daftar nama akun yang aktif dengan perintah ini:
gcloud auth list
- Klik Authorize.
Output:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
Untuk menetapkan akun aktif, jalankan:
$ gcloud config set account `ACCOUNT`
- (Opsional) Anda dapat menampilkan daftar ID project dengan perintah ini:
gcloud config list project
Output:
[core]
project = {{{project_0.project_id | "PROJECT_ID"}}}
Catatan: Untuk mendapatkan dokumentasi gcloud yang lengkap di Google Cloud, baca panduan ringkasan gcloud CLI.
Tugas 1. Membuat repositori Docker
Di bagian ini, Anda akan membuat repositori Docker pribadi dalam Artifact Registry. Repositori ini akan berfungsi sebagai lokasi pusat yang dapat digunakan untuk menyimpan dan mengelola image Docker Anda. Anda akan menggunakan alat command line gcloud untuk membuat repositori, lalu memverifikasi pembuatannya melalui Konsol Google Cloud.
-
Buka jendela Cloud Shell baru dengan mengklik ikon (
) di bagian pojok kanan atas konsol.
-
Jalankan perintah berikut untuk mendapatkan Project ID Anda dan menyimpannya sebagai variabel lingkungan:
export PROJECT_ID=$(gcloud config get-value project)
- Jalankan perintah berikut untuk membuat repositori Docker baru bernama
example-docker-repo di lokasi dengan deskripsi "Docker repository".
gcloud artifacts repositories create example-docker-repo --repository-format=docker \
--location={{{project_0.default_region | Region}}} --description="Docker repository" \
--project=$PROJECT_ID
- Jalankan perintah berikut untuk memverifikasi bahwa repositori Anda telah dibuat.
gcloud artifacts repositories list \
--project=$PROJECT_ID
-
Dari kotak penelusuran di bagian atas konsol, ketik Artifact Registry dan pilih hasil yang pertama.
-
Di halaman produk Artifact Registry, pastikan Anda dapat melihat repositori yang dibuat. Repositori tersebut akan terlihat seperti berikut:

- Klik repositori example-docker-repo. Anda akan melihat bahwa tidak ada file di dalam repositori. Di bagian berikutnya, Anda akan menambahkan file ke repositori.
Anda juga dapat membuat repositori dari halaman produk Artifact Registry dengan mengklik tombol Create Repository dan mengikuti langkah-langkah yang sama seperti di atas.
Klik Periksa progres saya untuk memverifikasi tujuan.
Membuat repositori Docker.
Tugas 2. Mengonfigurasi autentikasi untuk Artifact Registry
Untuk mengirim dan mengambil image dari repositori Docker yang baru dibuat, Anda harus mengonfigurasi Docker agar dapat melakukan autentikasi dengan Artifact Registry. Proses ini memerlukan penyiapan kredensial yang memungkinkan klien Docker Anda berinteraksi dengan repositori secara aman.
Sebelum dapat mengirim atau mengambil image, Anda harus mengonfigurasi Docker agar menggunakan Google Cloud CLI untuk mengautentikasi permintaan ke Artifact Registry.
- Untuk menyiapkan autentikasi ke repositori Docker di region , jalankan perintah berikut:
gcloud auth configure-docker {{{project_0.default_region | Region}}}-docker.pkg.dev
Perintah ini mengupdate konfigurasi Docker Anda. Sekarang Anda dapat terhubung dengan Artifact Registry di project Google Cloud untuk mengirim dan mengambil image.
Untuk mengetahui informasi tentang metode autentikasi lainnya, lihat Metode autentikasi.
Tugas 3. Mendapatkan image untuk dikirim
Anda memerlukan image Docker untuk digunakan di lab ini. Anda tidak perlu membangun image dari awal karena Anda hanya perlu mengambil contoh image bawaan dari repositori publik. Dengan demikian, Anda dapat berfokus untuk berinteraksi dengan Artifact Registry.
Untuk lab ini, Anda akan mengirim image contoh bernama hello-app.
- Jalankan perintah berikut untuk mengambil versi 1.0 dari image.
docker pull us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0
Jalur image di Artifact Registry mencakup beberapa bagian. Untuk image contoh ini:
-
us-docker.pkg.dev adalah nama host untuk image container yang disimpan di repositori Docker Artifact Registry, yang mencakup lokasi repositori (us).
-
google-samples adalah project ID.
-
containers adalah ID repositori.
-
/gke/hello-app adalah jalur ke image di containers repositori.
Tugas 4. Menambahkan image ke repositori
Sekarang Anda akan menambahkan contoh image ke repositori pribadi. Hal ini melibatkan pemberian tag pada image dengan nama repositori untuk menentukan tujuan, lalu mengirimnya ke Artifact Registry.
Sebelum mengirim image Docker ke Artifact Registry, Anda harus memberi tag pada image dengan nama repositori.
Memberi tag pada image dengan nama registry
Dengan memberikan tag pada image, Anda memastikan bahwa image tersebut dikirim ke lokasi yang benar, yaitu -docker.pkg.dev untuk lab ini.
- Jalankan perintah berikut untuk memberi tag pada image sebagai
sample-image:tag1:
docker tag us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0 \
{{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1
Dengan:
-
adalah lokasi repositori.
-
-docker.pkg.dev adalah nama host untuk repositori Docker yang Anda buat.
-
$PROJECT_ID adalah Project ID Google Cloud Anda.
-
example-docker-repo adalah ID repositori yang Anda buat.
-
sample-image adalah nama image yang ingin Anda gunakan di repositori. Nama image dapat berbeda dengan nama image lokal. Untuk lab ini, Anda akan menyimpan image langsung di bawah ID repositori example-docker-repo.
-
tag1 adalah tag yang Anda tambahkan ke image Docker. Jika Anda tidak menentukan tag, Docker akan menerapkan tag default latest.
Sekarang Anda siap untuk mengirim image ke repositori yang Anda buat.
Mengirim image ke Artifact Registry
Setelah mengonfigurasi autentikasi dan memberi tag pada image lokal, Anda dapat mengirim image ke repositori yang Anda buat.
Untuk mengirim image Docker, jalankan perintah berikut:
docker push {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1
Klik Periksa progres saya untuk memverifikasi tujuan.
Menambahkan image ke repositori.
Tugas 5. Mengambil image dari Artifact Registry
Terakhir, Anda akan mengambil image yang baru saja dikirim ke repositori pribadi Anda. Tindakan ini menyimulasikan cara Anda mengakses dan menggunakan image yang disimpan di Artifact Registry dalam skenario dunia nyata.
- Untuk mengambil image dari Artifact Registry ke komputer lokal Anda, jalankan perintah berikut:
docker pull {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1
Anda akan melihat output yang mirip dengan yang berikut:
latest: Pulling from [PROJECT-ID]/sample-image:tag1
Digest: sha256:70c42...
Status: Image is up to date for {{{project_0.default_region | Region}}}-docker.pkg.dev/$PROJECT_ID/example-docker-repo/sample-image:tag1
Selamat!
Di lab ini, Anda telah berhasil membuat repositori Docker pribadi di Artifact Registry, mengonfigurasi autentikasi, mengirim image contoh ke repositori, dan mengambil kembali image tersebut. Sekarang Anda memiliki pemahaman dasar tentang cara menggunakan Artifact Registry untuk mengelola image Docker.
Langkah berikutnya/pelajari lebih lanjut
Sertifikasi dan pelatihan Google Cloud
...membantu Anda mengoptimalkan teknologi Google Cloud. Kelas kami mencakup keterampilan teknis dan praktik terbaik untuk membantu Anda memahami dengan cepat dan melanjutkan proses pembelajaran. Kami menawarkan pelatihan tingkat dasar hingga lanjutan dengan opsi on demand, live, dan virtual untuk menyesuaikan dengan jadwal Anda yang sibuk. Sertifikasi membantu Anda memvalidasi dan membuktikan keterampilan serta keahlian Anda dalam teknologi Google Cloud.
Manual Terakhir Diperbarui pada 28 November 2024
Lab Terakhir Diuji pada 28 November 2024
Hak cipta 2025 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.