Menggunakan repositori gambar pribadi dengan apigeectl

Anda saat ini melihat versi 1.11 dari Dokumentasi Apigee Hybrid. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.11 

Versi yang didukung:

• v1.13 (terbaru)                        
• v1.12                         
• v1.11                         
• Daftar versi yang didukung

Versi yang tidak didukung:

• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Catatan: Prosedur ini mencakup petunjuk penggunaan apigeectl. Jika Anda menggunakan diagram Helm untuk mengelola Apigee Hybrid, lihat Menggunakan repositori image pribadi dengan diagram Helm.

Dokumen ini menjelaskan cara mengonfigurasi Apigee Hybrid untuk menggunakan image dari repositori image container pribadi.

Ringkasan

Semua image runtime hybrid Apigee dihosting di Google Cloud Container Registry (GCR). Jika karena alasan apa pun Anda ingin menggunakan repositori kontainer {i>image<i} pribadi, Anda dapat mengunduh {i>image<i} dari GCR, mendorongnya ke repositori pribadi Anda, dan mengganti lokasi gambar default di file overrides.yaml Anda.

Langkah konfigurasi

Ikuti langkah-langkah berikut untuk menggunakan repositori container image pribadi untuk image hybrid Apigee. Kepada melakukan langkah-langkah ini dan berhasil menggunakan gambar di repositori pribadi Anda, Anda harus terbiasa dengan prosedur penginstalan Apigee Hybrid. Dalam direktori ini, Anda berencana untuk mengonfigurasi repositori pribadi sebagai bagian dari instalasi hibrida baru.

1. Kirim image hybrid Apigee dari GCR ke repositori pribadi Anda. Sebaiknya gunakan apigee-push-pull untuk menyelesaikan langkah ini.

   Jika ingin melakukan langkah ini secara manual, Anda harus memiliki Docker diinstal dan gunakan perintah docker pull seperti berikut. Pastikan untuk menambahkan tag yang benar untuk setiap nama image. Misalnya, tag untuk apigee-synchronizer adalah 1.11.2, sebagaimana ditunjukkan di bawah ini.

   1. Dapatkan daftar terbaru semua gambar di project dengan opsi --list Utilitas apigee-pull-push.sh di Direktori apigeectl/tools/:

      apigee-pull-push.sh --list

   Output Anda akan terlihat seperti:

   apigee:
           gcr.io/apigee-release/hybrid/apigee-mart-server:1.11.2
           gcr.io/apigee-release/hybrid/apigee-synchronizer:1.11.2
           gcr.io/apigee-release/hybrid/apigee-runtime:1.11.2
           gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client:1.11.2
           gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra:1.11.2
           gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility:1.11.2
           gcr.io/apigee-release/hybrid/apigee-udca:1.11.2
           gcr.io/apigee-release/hybrid/apigee-connect-agent:1.11.2
           gcr.io/apigee-release/hybrid/apigee-watcher:1.11.2
           gcr.io/apigee-release/hybrid/apigee-operators:1.11.2
           gcr.io/apigee-release/hybrid/apigee-installer:1.11.2
           gcr.io/apigee-release/hybrid/apigee-redis:1.11.2
           gcr.io/apigee-release/hybrid/apigee-diagnostics-collector:1.11.2
           gcr.io/apigee-release/hybrid/apigee-diagnostics-runner:1.11.2
           gcr.io/apigee-release/hybrid/apigee-mint-task-scheduler:1.11.2
   third party:
           gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:1.10.5
           gcr.io/apigee-release/hybrid/apigee-prom-prometheus:v2.52.0
           gcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar:0.9.0
           gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy:v0.18.0
           gcr.io/apigee-release/hybrid/apigee-envoy:v1.27.0
           gcr.io/apigee-release/hybrid/apigee-prometheus-adapter:v0.12.0
           gcr.io/apigee-release/hybrid/apigee-asm-ingress:1.18.7-asm.26-distroless
           gcr.io/apigee-release/hybrid/apigee-asm-istiod:1.18.7-asm.26-distroless
           gcr.io/apigee-release/hybrid/apigee-fluent-bit:3.0.3
   

   2. Ambil image yang diperlukan untuk namespace apigee-system dan apigee dengan perintah docker pull. Contoh:

      docker pull gcr.io/apigee-release/hybrid/apigee-installer:1.11.2

      Daftar berikut menunjukkan image yang diperlukan untuk setiap namespace:

      Namespace apigee-system

      • apigee-installer
      • apigee-kube-rbac-proxy
      • apigee-operators

      Namespace apigee Anda

      • apigee-asm-ingress
      • apigee-asm-istiod
      • apigee-cassandra-backup-utility
      • apigee-connect-agent
      • apigee-diagnostics-collector
      • apigee-diagnostics-runner
      • apigee-envoy
      • apigee-fluent-bit
      • apigee-hybrid-cassandra-client
      • apigee-hybrid-cassandra
      • apigee-mart-server
      • apigee-prom-prometheus
      • apigee-prometheus-adapter
      • apigee-redis
      • apigee-runtime
      • apigee-stackdriver-logging-agent
      • apigee-stackdriver-prometheus-sidecar
      • apigee-synchronizer
      • apigee-udca
      • apigee-watcher
   3. Setelah Anda menarik dan memberi tag pada image, kirim ke repositori pribadi Anda. Lihat Docker push.
2. Buat Secret Kubernetes di namespace apigee dan apigee-system.

   Jika namespace ini tidak ada dalam cluster, Anda harus membuatnya sebelum melakukan langkah ini.

   Untuk mengetahui langkah-langkah pembuatan Secret, lihat Membuat Secret dengan memberikan kredensial di command line. Misalnya, untuk membuat rahasia dalam namespace apigee-system:

   kubectl create secret docker-registry SECRET_NAME -n apigee-system \
     --docker-server=YOUR_REGISTRY_SERVER \
     --docker-username=YOUR_DOCKER_USERNAME \
     --docker-email=YOUR_DOCKER_EMAIL \
     --docker-password="YOUR_DOCKER_PASSWORD)"

   Untuk membuat Secret dalam namespace apigee:

   kubectl create secret docker-registry SECRET_NAME -n apigee \
     --docker-server=YOUR_REGISTRY_SERVER \
     --docker-username=YOUR_DOCKER_USERNAME \
     --docker-email=YOUR_DOCKER_EMAIL \
     --docker-password="YOUR_DOCKER_PASSWORD)"

3. Tambahkan Secret tersebut ke file overrides.yaml Anda. Pembuatan file pengganti dijelaskan dalam langkah-langkah instalasi hibrida. Lihat Mengonfigurasi cluster untuk mengetahui detailnya.

   imagePullSecrets:
     - name: SECRET_NAME

4. Perbarui file overrides.yaml Anda dengan URL gambar untuk gambar yang disimpan di repositori pribadi. Setiap komponen yang disimpan dalam repositori memiliki image:url . Gunakan elemen ini untuk menentukan URL setiap gambar komponen. Contoh:

   mart:
     serviceAccountPath: /installdir/hybrid-files/service-accounts/hybrid-apigee-non-prod.json
     image:
       url: my-docker.pkg.dev/hybrid-1/registry-name/apigee-mart-server

   Ikuti pola ini untuk memperbarui setiap komponen hybrid tingkat atas di file overrides.yaml Anda dengan URL image repositori pribadi Anda. Contoh lengkap file pengganti disediakan bersama penginstalan hybrid Anda di $APIGEECTL_HOME/examples/private-overrides.yaml saat ini.

   Catatan: Anda hanya perlu memperbarui properti url. Anda dapat menerima nilai {i>default<i} untuk properti tag dan pullPolicy. Untuk mengetahui daftar lengkap komponen dan properti konfigurasinya, lihat juga Referensi properti konfigurasi.

Anda kini dapat menyelesaikan penginstalan hybrid baru menggunakan image pribadi, atau mengupdate penginstalan. Lihat Langkah-langkah penginstalan Apigee Hybrid untuk mengetahui informasi selengkapnya.

Menginstal pengelola sertifikat dari repositori pribadi

Untuk menginstal cert-manager dari repositori pribadi Anda, lihat Menginstal dengan Helm. Anda harus menginstal versi cert-manager yang sama seperti yang ditentukan dalam petunjuk Penginstalan Apigee Hybrid untuk memastikan kompatibilitas.