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. Bagian ini berfokus pada menyinkronkan konfigurasi dari repositori Git yang tidak terstruktur.

Halaman ini ditujukan bagi 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 konten Google Cloud , lihat Peran dan tugas pengguna GKE umum.

Untuk mengetahui petunjuk tentang 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 memberi otorisasi 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 Memberi 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, selesaikan langkah-langkah berikut:

console

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

gcloud

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

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

  • Untuk membuat cluster Standard yang terdaftar ke armada, 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 menyinkronkan konfigurasi dari repositori Git ke cluster terdaftar Anda, selesaikan langkah-langkah berikut:

console

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

Menginstal Config Sync

  1. Buka halaman Config Sync di konsol Google Cloud .

    Buka Config

  2. Klik Install Config Sync.

  3. Pilih Install on all clusters in the fleet.

  4. Biarkan semua setelan lainnya tetap pada nilai defaultnya.

  5. Klik Install Config Sync.

Di tab Setelan, setelah beberapa menit, Diaktifkan akan muncul di kolom Status untuk cluster di armada Anda.

Men-deploy paket

  1. Klik Deploy cluster package.

  2. Di tab Pilih cluster, pilih cluster yang ingin Anda deploy paketnya, lalu klik Lanjutkan.

  3. Klik tab Konfigurasi paket, lalu masukkan nama untuk paket Anda.

  4. Di bagian Sumber, 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 Setelan lanjutan untuk mengonfigurasi metode autentikasi Anda. Konsol Google Cloud menyediakan petunjuk tersemat untuk membantu Anda mengonfigurasi setelan autentikasi.

  6. Biarkan semua setelan lainnya tetap pada nilai defaultnya.

  7. Klik Deploy package.

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

gcloud

Jika menggunakan gcloud CLI, Anda menginstal Config Sync dengan membuat manifes yang berisi setelan Config Sync 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. Contoh manifes 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 tanda komentar dan ganti kolom ini jika Anda perlu menyinkronkan 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 mendapatkan 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. Dapatkan nama dengan perintah gcloud container fleet memberships list.
    • PROJECT_ID: Project ID Anda.

Memverifikasi penginstalan

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

console

  1. Buka halaman Config Sync di konsol Google Cloud .

    Buka Config Sync

  2. Di tab Paket, periksa kolom Status sinkronisasi di tabel cluster. Penginstalan Config Sync yang berhasil akan menampilkan status Diinstal. Repositori Git yang berhasil dikonfigurasi akan menampilkan status Disinkronkan.

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