בדף הזה מוסבר איך להגדיר אשכול אדמין של Google Distributed Cloud software only for VMware, כדי להשתמש ב-Artifact Registry של Google בתור מאגר Docker פרטי שבו אפשר לאחסן קובצי אימג' של עומסי עבודה. כשמגדירים מאגר פרטי לאחסון קובצי אימג' של עומסי עבודה, קובצי האימג' של המערכת של Google Distributed Cloud מאוחסנים גם במאגר הפרטי כשיוצרים או משדרגים אשכולות.
למרות ש-Artifact Registry תומך בכמה שיטות אימות שונות, כדי להשתמש ב-Artifact Registry כמאגר פרטי צריך להשתמש במפתח של חשבון שירות לצורך אימות. במאמר הזה מוסבר איך לקבל את הכתובת, את פרטי הכניסה ואת אישור ה-CA שנדרשים בקטע privateRegistry בקובץ התצורה של אשכול האדמין.
הגדרת קובץ של פרטי כניסה
אם לא הגדרתם אימות למאגר, בצעו את השלבים שמפורטים במאמר הגדרת אימות ל-Artifact Registry בשביל Docker כדי להגדיר אימות באמצעות חשבון שירות. כדי לבצע אימות, אתם צריכים להשתמש בחשבון שירות עם קובץ מפתח JSON.
יוצרים קובץ תצורה של פרטי כניסה,
admin-creds.yaml, כמו בדוגמה הבאה. הערך שלusernameחייב להיות"_json_key". אפשר להשתמש בכל ערך בשדהname, כל עוד הוא תואם לערך שתוסיפו לשדהprivateRegistry.entry.apiVersion: v1 kind: "CredentialFile" items: - name: "private-registry-creds" username: "_json_key" password:בספרייה שבה נמצא קובץ המפתח בפורמט JSON של חשבון השירות של המרשם, מריצים את הפקודה
catעל קובץ המפתח כדי להציג את התוכן.מעתיקים את כל התוכן של מפתח ה-JSON ומדביקים אותו בשדה
password. חשוב להקיף את תוכן מפתח ה-JSON בגרשיים, כי התוכן מכיל מירכאות כפולות. לדוגמה:apiVersion: v1 kind: "CredentialFile" items: - name: "private-registry-creds" username: "_json_key" password: '{ "type": "service_account", "project_id": "example-project-12345", "private_key_id": "d2661ccb21e686658c6552cf1e0166b857091b2e", "private_key": "-----BEGIN PRIVATE ... -----END PRIVATE KEY-----\n", "client_email": "test-537@example-project-12345.", "client_id": "111772984510027821291", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/test-537%40example-project-12345.", "universe_domain": "googleapis.com" } '
הגדרת privateRegistry בקובץ התצורה של אשכול האדמין
כדי להשתמש במרשם פרטי, צריך להגדיר את הקטע privateRegistry כשיוצרים את אשכול האדמין. אחרי שיוצרים את האשכול, אי אפשר לשנות את הערך של privateRegistry.address, אבל אפשר לשנות את ההגדרות האחרות ולעדכן אותן לפי הצורך.
מריצים את הפקודה הבאה כדי לקבל את כתובת המרשם:
gcloud artifacts repositories describe REGISTRY_NAME \ --project=PROJECT_ID --location=REGIONמחליפים את מה שכתוב בשדות הבאים:
-
REGISTRY_NAME: שם המרשם. -
PROJECT_ID: מזהה הפרויקט שבו נוצר המרשם. -
LOCATION: האזור שבו נוצר המרשם, למשלus-west2.
הפלט אמור להיראות כך:
Encryption: Google-managed key Repository Size: 0.000MB cleanupPolicyDryRun: true createTime: '2025-01-28T03:27:57.701672Z' dockerConfig: {} format: DOCKER mode: STANDARD_REPOSITORY name: projects/example-project-12345/locations/us-west2/repositories/test registryUri: us-west2-docker.pkg.dev/example-project-12345/test satisfiesPzi: true updateTime: '2025-01-28T03:27:57.701672Z' vulnerabilityScanningConfig: enablementConfig: INHERITED enablementState: SCANNING_ACTIVE lastEnableTime: '2025-01-28T03:27:49.385246079Z'משתמשים בערך
registryUriבפלט שלprivateRegistry.address.-
מריצים את הפקודה הבאה כדי לחלץ את אישור ה-CA של נקודת הקצה של Artifact Registry ולשמור אותו בקובץ בשם
ar-ca.pem:true | openssl s_client -connect REGION-docker.pkg.dev:443 -showcerts 2>/dev/null| sed -ne '/-BEGIN/,/-END/p' > ar-ca.pemממלאים את הקטע
privateRegistryבאופן הבא:privateRegistry: address: "REGISTRY_ADDRESS" credentials: fileRef: path: "CREDENTIAL_FILE_PATH" entry: "private-registry-creds" caCertPath: "CA_CERT_PATH" componentAccessServiceAccountKeyPath: "COMPONENT_ACCESS_KEY_PATH"מחליפים את מה שכתוב בשדות הבאים:
-
REGISTRY_ADDRESS: הערך שלregistryUri. -
CREDENTIAL_FILE_PATH: הנתיב המלא או הנתיב היחסי של הקובץadmin-creds.yaml. -
CA_CERT_PATH: הנתיב המלא או היחסי של הקובץar-ca.pem. -
COMPONENT_ACCESS_KEY_PATH: הנתיב המלא או הנתיב היחסי של קובץ המפתח של חשבון השירות לגישה לרכיבים.
-