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 container image pribadi,
Anda dapat mendownload image dari GCR, memasukkannya ke repositori pribadi, dan mengganti
lokasi image default dalam file overrides.yaml
Anda.
Langkah konfigurasi
Ikuti langkah-langkah berikut untuk menggunakan repositori container image pribadi untuk image hybrid Apigee. Agar dapat melakukan langkah-langkah ini dan berhasil menggunakan image di repositori pribadi, Anda harus memahami prosedur penginstalan Apigee Hybrid. Dalam skenario umum, Anda berencana untuk mengonfigurasi repositori pribadi sebagai bagian dari penginstalan hybrid baru.
- Kirim image hybrid Apigee dari GCR ke repositori pribadi Anda. Sebaiknya gunakan utilitas apigee-push-pull untuk menyelesaikan langkah ini.
Jika lebih suka melakukan langkah ini secara manual, Anda harus menginstal Docker dan menggunakan perintah
docker pull
seperti berikut. Pastikan untuk menambahkan tag yang benar ke setiap nama gambar. Misalnya, tag untukapigee-synchronizer
adalah1.8.8
, seperti yang ditunjukkan di bawah ini.Berikut adalah gambar untuk namespace
apigee-system
danapigee
:Ruang nama:
apigee-system
docker pull gcr.io/apigee-release/hybrid/apigee-installer:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy:v0.11.0
docker pull gcr.io/apigee-release/hybrid/apigee-operators:1.8.8
Ruang nama:
apigee
docker pull gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-connect-agent:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-diagnostics-collector:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-envoy:v1.21.0
docker pull gcr.io/apigee-release/hybrid/apigee-fluent-bit:1.9.9
docker pull gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-mart-server:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-mint-task-scheduler:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-prom-prometheus:v2.33.5
docker pull gcr.io/apigee-release/hybrid/apigee-prometheus-adapter:v0.9.1
docker pull gcr.io/apigee-release/hybrid/apigee-redis:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-runtime:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:1.8.9
docker pull gcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar:0.9.0
docker pull gcr.io/apigee-release/hybrid/apigee-synchronizer:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-udca:1.8.8
docker pull gcr.io/apigee-release/hybrid/apigee-watcher:1.8.8
Setelah menarik dan memberi tag pada image, Anda harus mengirimnya ke repositori pribadi Anda. Lihat docker push.
- Buat Secret Kubernetes di namespace
apigee
danapigee-system
.Jika namespace ini tidak ada dalam cluster, Anda harus membuatnya sebelum melakukan langkah ini.
Untuk langkah-langkah membuat Secret, lihat Membuat Secret dengan memberikan kredensial pada command line. Misalnya, untuk membuat secret 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 di 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)"
- Tambahkan Secret ke file
overrides.yaml
Anda. Pembuatan file penggantian dijelaskan dalam langkah-langkah penginstalan hybrid. Untuk mengetahui detailnya, lihat Mengonfigurasi cluster.imagePullSecrets: - name: SECRET_NAME
- Update file
overrides.yaml
dengan URL gambar untuk gambar yang disimpan di repositori pribadi Anda. Setiap komponen yang disimpan dalam repositori memiliki elemenimage:url
. Gunakan elemen ini untuk menentukan URL setiap image 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 pribadinya. Contoh lengkap file penggantian diberikan bersama penginstalan hybrid di direktori$APIGEECTL_HOME/examples/private-overrides.yaml
.
Sekarang Anda dapat menyelesaikan penginstalan hybrid baru menggunakan image pribadi, atau mengupdate penginstalan yang ada. Lihat Langkah-langkah penginstalan hybrid Apigee 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 hybrid Apigee untuk memastikan kompatibilitas.