Menginstal Config Sync dengan setelan default

Config Sync menyinkronkan konfigurasi Kubernetes Anda dengan cluster Anda. Dokumen ini menjelaskan cara mengaktifkan dan mengonfigurasi Config Sync menggunakan setelan default. Dokumen ini berfokus pada sinkronisasi konfigurasi dari repositori Git yang tidak terstruktur.

Halaman ini ditujukan untuk Operator yang ingin menerapkan alat GitOps untuk memusatkan pengelolaan konfigurasi bagi tim mereka. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam Google Cloud konten, lihat Peran dan tugas pengguna GKE umum.

Untuk mengetahui petunjuk cara menginstal Config Sync dengan setelan lanjutan, lihat Menyesuaikan penginstalan Config Sync.

Sebelum memulai

Sebelum menginstal Config Sync, siapkan repositori Git dan cluster GKE Anda.

Membuat repositori Git dan memberikan akses ke Config Sync

Untuk menyinkronkan konfigurasi dari repositori Git ke cluster Anda, Config Sync memerlukan akses hanya baca ke repositori Anda. Untuk mengotorisasi Config Sync agar dapat membaca konfigurasi Anda, selesaikan langkah-langkah berikut:

  • Buat, atau miliki akses ke, repositori Git yang berisi file konfigurasi yang ingin Anda sinkronkan oleh Config Sync ke cluster Anda.

  • Jika repositori Git Anda bersifat publik, Anda tidak perlu melakukan tindakan lebih lanjut. Config Sync tidak memerlukan izin tambahan.

  • Jika repositori Git Anda bersifat pribadi, ikuti petunjuk di Memberikan akses Config Sync ke Git.

Membuat cluster

Jika Anda sudah menyiapkan cluster, misalnya jika Anda mengikuti langkah-langkah untuk Memberikan akses Config Sync ke Git, lanjutkan ke Menginstal Config Sync.

Config Sync mengharuskan cluster Anda didaftarkan ke fleet. Untuk mendaftarkan cluster Anda, selesaikan langkah berikut:

console

Anda tidak perlu melakukan tindakan apa pun. Cluster Anda akan otomatis didaftarkan ke fleet saat Anda menginstal Config Sync.

gcloud

  • Untuk membuat cluster Autopilot yang terdaftar ke fleet, jalankan perintah berikut:

    gcloud container clusters create-auto CLUSTER_NAME --enable-fleet

  • Untuk membuat cluster Standard yang terdaftar ke fleet, jalankan perintah berikut:

    gcloud container clusters create CLUSTER_NAME --enable-fleet \
    --workload-pool=PROJECT_ID.svc.id.goog

Ganti kode berikut:

  • CLUSTER_NAME: nama cluster Anda.
  • PROJECT_ID: project ID Anda.

Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan cluster, lihat Mendaftarkan cluster ke fleet.

Menginstal Config Sync

Untuk mengaktifkan dan mengonfigurasi Config Sync agar dapat menyinkronkan konfigurasi dari repositori Git Anda ke cluster terdaftar Anda, selesaikan langkah-langkah berikut:

console

Jika Anda menggunakan Google Cloud console, Anda harus menginstal Config Sync di cluster Anda terlebih dahulu, lalu mengonfigurasi paket yang memungkinkan Config Sync melakukan sinkronisasi dari repositori Git Anda.

Menginstal Config Sync

  1. Buka halaman Config Sync di Google Cloud console.

    Buka Config

  2. Klik Install Config Sync.

  3. Pilih Install on all clusters in the fleet.

  4. Biarkan semua setelan lainnya pada nilai defaultnya.

  5. Klik Install Config Sync.

Di tab Settings, setelah beberapa menit, Enabled akan muncul di kolom Status untuk cluster di fleet Anda.

Men-deploy paket

  1. Klik Deploy cluster package.

  2. Di tab Select clusters , pilih cluster yang ingin Anda deploy paketnya, lalu klik Continue.

  3. Klik tab Configure package dan masukkan nama untuk paket Anda.

  4. Di bagian Source, selesaikan langkah-langkah berikut:

    1. Di kolom Repository URL, masukkan URL repositori Git Anda.

    2. Opsional: Tinjau dan perbarui setelan kolom lainnya. Anda mungkin tidak perlu memperbarui setelan ini, bergantung pada struktur repositori Anda.

  5. Opsional: Jika repositori Anda bersifat pribadi, luaskan bagian Advanced settings untuk mengonfigurasi metode autentikasi Anda. console menyediakan petunjuk tersemat untuk membantu Anda mengonfigurasi setelan autentikasi Anda. Google Cloud

  6. Biarkan semua setelan lainnya pada nilai defaultnya.

  7. Klik Deploy package.

Anda akan dialihkan ke halaman Packages Config Sync. Setelah beberapa menit, Synced akan muncul di kolom Sync status untuk cluster yang Anda konfigurasi.

gcloud

Jika Anda menggunakan gcloud CLI, Anda harus menginstal Config Sync dengan membuat manifes yang berisi setelan Config Sync Anda, lalu menerapkan setelan tersebut ke cluster Anda.

  1. Aktifkan fitur fleet ConfigManagement:

    gcloud beta container fleet config-management enable

  2. Buat manifes bernama apply-spec.yaml. Manifes contoh ini berisi setelan default yang direkomendasikan:

    applySpecVersion: 1
spec:
  configSync:
    enabled: true
    sourceFormat: unstructured
    syncRepo: REPO_URL
    # syncRev: REVISION
    secretType: none
    preventDrift: false

    Ganti kode berikut:

    • REPO_URL: URL repositori Git Anda, misalnya, https://github.com/GoogleCloudPlatform/anthos-config-management-samples.

    • (Opsional) REVISION: Revisi Git (tag atau hash) atau cabang yang ingin Anda sinkronkan. Hapus komentar dan ganti kolom ini jika Anda perlu melakukan sinkronisasi dari lokasi selain HEAD.

      Untuk repositori pribadi, Anda dapat mengubah kolom secretType ke metode autentikasi yang didukung. Akun layanan Google (gcpserviceaccount) dengan Secure Source Manager umumnya direkomendasikan. Atau, gunakan ssh karena berfungsi dengan sebagian besar penyedia Git. Untuk mengetahui petunjuk yang lebih mendetail tentang metode autentikasi yang didukung, lihat Memberikan akses ke Git.

  3. Terapkan manifes ke cluster Anda:

    gcloud beta container fleet config-management apply \
    --membership=MEMBERSHIP_NAME \
    --config=apply-spec.yaml \
    --project=PROJECT_ID

    Ganti kode berikut:

    • MEMBERSHIP_NAME: nama keanggotaan fleet yang Anda pilih saat mendaftarkan cluster Anda. Dapatkan nama tersebut dengan perintah gcloud container fleet memberships list.
    • PROJECT_ID: Project ID Anda.

Memverifikasi penginstalan

Setelah Anda menginstal dan mengonfigurasi Config Sync, pastikan penginstalan berhasil diselesaikan.

console

  1. Buka halaman Config Sync di Google Cloud console.

    Buka Config Sync

  2. Di tab Packages, periksa kolom Sync status di tabel cluster. Penginstalan Config Sync yang berhasil akan menampilkan status Installed. Repositori Git yang berhasil dikonfigurasi akan menampilkan status Synced.

gcloud

Jalankan perintah berikut:

nomos status

Penginstalan yang berhasil akan menampilkan status SYNCED atau PENDING.

Untuk mengetahui detail selengkapnya tentang informasi yang diberikan oleh perintah nomos status, termasuk error yang dilaporkan, lihat Memeriksa status Config Sync di dokumentasi alat command line nomos.

Langkah berikutnya