שימוש במאגר תמונות פרטי

במסמך הזה מוסבר איך להגדיר את Apigee Hybrid כך שישתמש בקובצי אימג' של קונטיינר ממאגר פרטי של קובצי אימג' של קונטיינר.

סקירה כללית

כל תמונות זמן הריצה של Apigee Hybrid מתארחות ב- Google Cloud Container Registry ‏ (GCR). אם מסיבה כלשהי אתם רוצים להשתמש במאגר פרטי של קונטיינרים של תמונות, אתם יכולים להוריד את התמונות מ-GCR, להעלות אותן למאגר הפרטי ולשנות את מיקומי התמונות שמוגדרים כברירת מחדל בקובץ overrides.yaml.

שלבי ההגדרה

כדי להשתמש במאגר פרטי של קונטיינרים של תמונות עבור תמונות של Apigee hybrid: כדי לבצע את השלבים האלה ולהשתמש בהצלחה בתמונות במאגר הפרטי, צריך להכיר את תהליך ההתקנה של Apigee hybrid. בדרך כלל, תתכננו להגדיר את המאגר הפרטי כחלק מהתקנה היברידית חדשה.

  1. מעבירים את תמונות Apigee hybrid מ-GCR למאגר הפרטי. מומלץ להשתמש בכלי השירות apigee-push-pull כדי לבצע את השלב הזה.

    אם אתם מעדיפים לבצע את השלב הזה באופן ידני, אתם צריכים להתקין את Docker ולהשתמש בפקודה docker pull באופן הבא. חשוב להוסיף את התג הנכון לכל שם תמונה. לדוגמה, התג של apigee-synchronizer הוא 1.9.4, כמו שמוצג בהמשך.

    התמונות של מרחבי השמות apigee-system ו-apigee:

    מרחב שמות: apigee-system 

    docker pull gcr.io/apigee-release/hybrid/apigee-installer:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy:v0.14.0
docker pull gcr.io/apigee-release/hybrid/apigee-operators:1.9.4

    מרחב שמות: apigee 

    docker pull gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-connect-agent:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-diagnostics-collector:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-envoy:v1.25.1
docker pull gcr.io/apigee-release/hybrid/apigee-fluent-bit:2.1.3
docker pull gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-mart-server:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-mint-task-scheduler:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-prom-prometheus:v2.39.1
docker pull gcr.io/apigee-release/hybrid/apigee-prometheus-adapter:v0.10.0
docker pull gcr.io/apigee-release/hybrid/apigee-redis:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-runtime:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:1.9.12-2
docker pull gcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar:0.9.0
docker pull gcr.io/apigee-release/hybrid/apigee-synchronizer:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-udca:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-watcher:1.9.4
docker pull gcr.io/apigee-release/hybrid/apigee-asm-ingress:1.17.2-asm.8-distroless
docker pull gcr.io/apigee-release/hybrid/apigee-asm-istiod:1.17.2-asm.8-distroless

    אחרי שמושכים את התמונות ומתייגים אותן, צריך לדחוף אותן למאגר הפרטי. מידע נוסף זמין במאמר בנושא docker push.

  2. יוצרים סוד של Kubernetes במרחבי השמות apigee ו-apigee-system.

    אם מרחבי השמות האלה לא קיימים באשכול, צריך ליצור אותם לפני שמבצעים את השלב הזה.

    הוראות ליצירת סוד מפורטות במאמר יצירת סוד באמצעות הזנת פרטי כניסה בשורת הפקודה. לדוגמה, כדי ליצור Secret במרחב השמות 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)"

    כדי ליצור Secret במרחב השמות 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. מוסיפים את הסוד לקובץ overrides.yaml. הסבר על יצירת קובץ ההחלפות מופיע בשלבי ההתקנה ההיברידית. פרטים נוספים זמינים במאמר הגדרת האשכול. 
    imagePullSecrets:
  - name: SECRET_NAME
  4. מעדכנים את קובץ overrides.yaml עם כתובות URL של תמונות שמאוחסנות במאגר הפרטי. לכל רכיב שמאוחסן במאגר יש רכיב image:url. משתמשים ברכיב הזה כדי לציין את כתובת ה-URL של כל תמונה ברכיב. לדוגמה: 
    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

    פועלים לפי התבנית הזו כדי לעדכן כל רכיב היברידי ברמה העליונה בקובץ overrides.yaml עם כתובת ה-URL של תמונת המאגר הפרטי שלו. דוגמה מלאה לקובץ החלפה מסופקת עם ההתקנה ההיברידית בספרייה $APIGEECTL_HOME/examples/private-overrides.yaml.

עכשיו אפשר להשלים התקנה היברידית חדשה באמצעות התמונות הפרטיות, או לעדכן את ההתקנה הקיימת. מידע נוסף זמין בשלבים להתקנת Apigee hybrid.

התקנת cert-manager ממאגר פרטי

כדי להתקין את cert-manager מהמאגר הפרטי, אפשר לעיין במאמר בנושא התקנה באמצעות Helm. חשוב להתקין את אותה גרסה של cert-manager שצוינה בהוראות להתקנת Apigee hybrid כדי להבטיח תאימות.