Men-deploy resource di seluruh fleet

Men-deploy resource di seluruh fleet

Tutorial ini mengajarkan cara menggunakan paket armada untuk men-deploy manifes resource Kubernetes di seluruh armada cluster. Penggunaan alat GitOps seperti paket fleet Config Sync dapat membantu Anda menskalakan pengelolaan konfigurasi di sejumlah besar cluster.

Dalam tutorial ini, Anda akan menyelesaikan tugas berikut:

• Menghubungkan repositori Git ke Cloud Build
• Membuat dan mendaftarkan cluster ke fleet
• Menginstal Config Sync sebagai default armada
• Men-deploy resource dari repositori ke fleet cluster Anda

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Instal Google Cloud CLI.

Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan GKE, Config Delivery (paket fleet), Cloud Build, Developer Connect API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable container.googleapis.com  configdelivery.googleapis.com  cloudbuild.googleapis.com  developerconnect.googleapis.com

Instal Google Cloud CLI.

Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan GKE, Config Delivery (paket fleet), Cloud Build, Developer Connect API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable container.googleapis.com  configdelivery.googleapis.com  cloudbuild.googleapis.com  developerconnect.googleapis.com

1. Buat, atau miliki akses ke, akun GitHub.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloudyang dapat ditagih berikut:

• GKE
• Cloud Build

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga.

Pengguna Google Cloud baru mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Menghubungkan ke Git

Repositori Git Anda berisi resource yang ingin Anda deploy di seluruh kumpulan. Untuk men-deploy resource tersebut dengan paket armada, Anda harus menghubungkan repositori Git ke Cloud Build.

Membuat repositori Git Anda

Tutorial ini menggunakan GitHub sebagai penyedia Git. Untuk membuat repositori GitHub baru, selesaikan langkah-langkah berikut:

1. Di browser web, buka GitHub.

2. Jika perlu, login ke akun GitHub Anda. Jika Anda memiliki akses ke organisasi atau tim lain di GitHub, pastikan Anda membuat repositori dengan akun pribadi Anda.

3. Dari toolbar, pilih Tambahkan , lalu klik Repositori baru.

4. Ketik fleet-package-tutorial sebagai nama repositori.

5. Biarkan Publik dipilih sebagai visibilitas repositori.

6. Pilih Buat repositori.

Menghubungkan repositori ke Cloud Build

Layanan paket fleet Config Sync menggunakan Cloud Build untuk menyinkronkan dan mengambil resource Kubernetes dari repositori Git Anda.

Untuk menghubungkan repositori GitHub Anda ke Cloud Build, selesaikan langkah-langkah berikut:

1. Buka halaman Cloud Build di konsol Google Cloud , lalu pilih Repositories.

   Buka halaman Repositori

2. Pastikan Anda berada di halaman Repositories generasi ke-2. Jika perlu, pilih Lihat repositori (generasi ke-2).

3. Klik Create host connection.

4. Di menu Region, pilih us-central1 (Iowa) sebagai region Anda.

   Perhatian: Anda hanya dapat memilih us-central1 (Iowa) sebagai region. Koneksi Cloud Build dan paket fleet harus berada di region yang sama. Paket armada (Pratinjau) hanya mendukung us-central1.

5. Di kolom Name, ketik fleet-package-quickstart-connection sebagai nama untuk koneksi Anda.

6. Klik Hubungkan.

7. Jika ini pertama kalinya Anda menghubungkan Cloud Build ke akun GitHub, selesaikan langkah-langkah berikut:

   1. Terima permintaan untuk token OAuth GitHub Anda. Token disimpan di Secret Manager untuk digunakan dengan Koneksi GitHub Cloud Build. Klik Lanjutkan.
   2. Instal Cloud Build ke repositori GitHub Anda. Pilih Instal di akun baru.
   3. Di jendela GitHub baru yang terbuka, pilih akun GitHub tempat Anda membuat fork Cymbal Bank sebelumnya. Di lingkungan produksi, Anda dapat memilih akun atau repositori lain yang telah Anda delegasikan aksesnya.
   4. Ikuti perintah autentikasi apa pun untuk mengonfirmasi identitas Anda di GitHub.
   5. Di jendela GitHub untuk akses repositori Cloud Build, pilih Only select repositories.
   6. Dari menu drop-down yang mencantumkan repositori, pilih repositori fleet-package-tutorial Anda.
   7. Klik Simpan.

8. Di halaman Cloud Build di konsol Google Cloud , klik Link repository untuk menghubungkan repositori Git baru ke Cloud Build.

9. Di menu Connection, pilih fleet-package-quickstart-connection.

10. Di menu Repositories, pilih repositori fleet-package-tutorial Anda.

11. Pilih Tautkan.

Menyiapkan fleet Anda

Di bagian ini, Anda akan menyiapkan fleet dengan membuat cluster, mendaftarkannya ke fleet, dan menginstal Config Sync sebagai paket fleet.

Membuat cluster

Untuk mendemonstrasikan cara menggunakan paket armada untuk men-deploy resource di beberapa cluster, tutorial ini menunjukkan cara membuat dua cluster.

Catatan: Pembuatan setiap cluster dapat memerlukan waktu hingga 15 menit.

Untuk membuat dua cluster dan mendaftarkannya ke fleet project Anda:

1. Buat cluster GKE:

   gcloud container clusters create-auto cluster1 \
     --project=PROJECT_ID \
     --region=REGION \
     --fleet-project=PROJECT_ID \
     --release-channel=rapid
   

   Ganti kode berikut:

   • PROJECT_ID dengan ID project Anda.
   • REGION dengan region tempat Anda ingin membuat cluster, seperti us-central1.

2. Buat cluster GKE kedua:

   gcloud container clusters create-auto cluster2 \
     --project=PROJECT_ID \
     --region=REGION \
     --fleet-project=PROJECT_ID \
     --release-channel=rapid
   

Menginstal Config Sync sebagai default armada

Untuk menggunakan layanan paket armada, Config Sync harus diinstal di kedua cluster. Anda dapat menginstal Config Sync di beberapa cluster sekaligus, dan semua cluster mendatang yang terdaftar ke fleet, dengan menyelesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Feature Manager.

   Buka Pengelola Fitur

2. Di panel Config Sync, klik Configure.

3. Klik Sesuaikan setelan armada. Pada dialog yang muncul, pilih versi Config Sync yang akan diinstal.

4. Klik Configure.

5. Pada dialog konfirmasi Mengonfigurasi setelan armada, klik Konfirmasi. Jika Anda belum pernah mengaktifkan Config Sync, mengklik Confirm juga akan mengaktifkan anthosconfigmanagement.googleapis.com API.

6. Di tabel Clusters in the fleet, pilih kedua cluster, lalu klik Sync to fleet settings. Tindakan ini akan menginstal Config Sync di kedua Cluster dengan setelan yang Anda konfigurasi.

   Mungkin perlu waktu beberapa menit hingga cluster disinkronkan. Anda dapat melanjutkan ke langkah berikutnya jika Config Sync ditampilkan sebagai Diinstal.

Menyiapkan akun layanan untuk Cloud Build

Untuk membuat akun layanan dan memberikan izin yang diperlukan ke Cloud Build, selesaikan langkah-langkah berikut:

1. Buat akun layanan:

   gcloud iam service-accounts create "quickstart-service-account"
   

2. Beri akun layanan izin untuk mengambil resource dari repositori Git Anda dengan menambahkan binding kebijakan IAM untuk peran Penerbit Paket Resource:

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" \
      --role='roles/configdelivery.resourceBundlePublisher'
   

   Jika diminta, pilih None sebagai kondisi untuk kebijakan.

3. Beri akun layanan izin untuk menulis log dengan menambahkan binding kebijakan IAM untuk peran Logs Writer:

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" \
      --role='roles/logging.logWriter'
   

   Jika diminta, pilih None sebagai kondisi untuk kebijakan.

4. Tambahkan binding kebijakan IAM untuk peran Artifact Registry Writer:

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" \
      --role='roles/artifactregistry.writer'
   

   Jika diminta, pilih None sebagai kondisi untuk kebijakan.

Men-deploy resource di seluruh perangkat Anda

Dalam tutorial ini, Anda akan menambahkan manifes Kubernetes dengan deployment nginx ke repositori Git, memublikasikan rilis, lalu membuat paket armada untuk men-deploy aplikasi nginx.

Lakukan commit manifes Kubernetes ke repositori Anda

Untuk menambahkan resource ke GitHub dan memublikasikan rilis, selesaikan langkah-langkah berikut:

1. Di jendela browser web repositori GitHub Anda, klik Add file, lalu Create new file.

2. Beri nama file Anda deployment.yaml dan tempelkan konten berikut ke dalamnya:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - image: nginx:1.14.2
           name: nginx
           ports:
           - containerPort: 80
   

3. Klik Commit changes...

4. Pada dialog konfirmasi, biarkan opsi Lakukan langsung ke cabang main tetap dipilih, lalu klik Lakukan perubahan.

5. Di halaman utama repositori Anda, pilih Rilis dari sidebar.

6. Di bagian atas halaman, pilih Buat rilis baru.

7. Pilih menu Pilih tag, lalu ketik v1.0.0 sebagai tag. Klik Buat tag baru.

8. Klik Publikasikan rilis.

Men-deploy resource ke cluster dengan paket fleet

Untuk men-deploy resource baru, buat paket armada baru:

1. Paket fleet ini menargetkan semua cluster di fleet Anda karena tidak menentukan pemilih cluster (di bagian target.fleet). Paket ini dikonfigurasi untuk men-deploy varian deployment (yang berasal dari file deployment.yaml Anda) ke semua cluster ini.

   Di Cloud Shell, buat file bernama fleet-package.yaml dengan konten berikut:

   resourceBundleSelector:
     cloudBuildRepository:
       name: projects/PROJECT_ID/locations/us-central1/connections/fleet-package-quickstart-connection/repositories/REPOSITORY_NAME
       tag: v1.0.0
       serviceAccount: projects/PROJECT_ID/serviceAccounts/quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com
       path:
       # Match all files (including deployment.yaml) to generate variants
       variantsPattern: "*.yaml"
   target:
     fleet:
       project: projects/PROJECT_ID
   rolloutStrategy:
     rolling:
       maxConcurrent: 1
   variantSelector:
     # Explicitly match the variant generated from "deployment.yaml"
     variantNameTemplate: "deployment"
   

   Ganti REPOSITORY_NAME dengan nama repositori dari Cloud Build. Ini biasanya dalam format USERNAME-REPOSITORY_NAME.

2. Buat paket fleet untuk memulai peluncuran:

   gcloud container fleet packages create fp-nginx \
      --source=fleet-package.yaml \
      --project=PROJECT_ID
   

3. Pastikan paket armada telah dibuat:

   gcloud container fleet packages list
   

   Anda dapat mengklik link yang diberikan untuk melihat log streaming untuk tugas Cloud Build.

   Paket armada mulai men-deploy resource Kubernetes di seluruh armada Anda.

4. Di halaman Google Kubernetes Engine di konsol Google Cloud , buka halaman Workloads untuk melihat tampilan gabungan workload yang di-deploy di semua cluster GKE Anda:

   Buka halaman Workloads

   Diperlukan waktu beberapa menit agar beban kerja tersedia. Anda mungkin juga melihat error ketersediaan saat Autopilot menyesuaikan permintaan resource untuk deployment baru.

   Perhatikan bagaimana, karena maxConcurrent: disetel ke 1 dalam definisi paket armada Anda, API paket armada menunggu hingga nginx-deployment di-deploy sepenuhnya di satu cluster sebelum memulai deployment ke cluster kedua. Jika Anda mengubah strategi peluncuran menjadi maxConcurrent: 2 atau yang lebih tinggi, resource akan di-deploy ke kedua cluster secara bersamaan.

   Setelah beberapa menit, Anda akan melihat dua workload baru untuk nginx-deployment di kedua cluster Anda. Anda mungkin perlu memuat ulang halaman.

Berhasil: Anda menggunakan satu paket fleet untuk menambahkan deployment baru yang bersumber di repositori Git ke dua cluster.

Anda dapat terus menjelajahi berbagai strategi deployment dengan paket armada. Misalnya, Anda dapat menambahkan cluster baru ke armada untuk mengamati bahwa workload Anda di-deploy secara otomatis ke cluster baru tersebut. Untuk mengetahui informasi selengkapnya tentang strategi dan variasi deployment, lihat Men-deploy paket armada.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

Perhatian: Penghapusan project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di Konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Anda dapat menghapus repositori dengan menyelesaikan langkah-langkah berikut:

1. Di jendela browser web repositori GitHub Anda, di bagian nama repositori, klik Setelan.

2. Di halaman Setelan umum (yang dipilih secara default), buka bagian Danger Zone, lalu klik Hapus repositori ini.

3. Klik Saya ingin menghapus repositori ini.

4. Baca peringatan dan klik Saya telah membaca dan memahami efek ini.

5. Untuk memverifikasi bahwa Anda menghapus repositori yang benar, di kolom teks, ketik nama repositori Anda.

6. Klik Delete this repository.

Langkah berikutnya

• Pelajari lebih lanjut paket armada.
• Pelajari cara men-deploy paket armada.
• Coba tutorial aplikasi Scalable apps tutorial, serangkaian tutorial yang mengajarkan cara men-deploy, menjalankan, dan mengelola lingkungan aplikasi modern di GKE. Bagian ini mencakup tutorial Memusatkan pengelolaan perubahan yang membahas cara menskalakan perubahan konfigurasi dengan paket armada.