מופעי Harbor משתמשים באישורי Transport Layer Security (TLS) שהונפקו על ידי רשות אישורי הבסיס (CA) המהימנה של הארגון. כך החיבור בין לקוח Docker לבין המרשם של Harbor מוצפן, והאימג'ים מאובטחים מפני גישה לא מורשית.
בדף הזה מוסבר איך להגדיר את לקוח Docker בתחנת העבודה כך שיסמוך על רשות האישורים (CA) ברמה הבסיסית (root) של Harbor. אתם לא צריכים להגדיר אמון בצמתים של אשכולות Kubernetes, כי GDC מגדיר את צומתי האשכולות כך שיאמינו למכונות של מאגר Harbor באופן אוטומטי. למידע נוסף, ראו אמינות של צומת אשכול למופעים של מרשם Harbor.
לפני שמתחילים
לפני שאתם מנהלים את קובצי האימג' של הקונטיינרים, אתם צריכים לבצע את השלבים הבאים:
- אם Docker לא מותקן, מתקינים אותו לפי ההוראות שמפורטות בכתובת https://docs.docker.com/engine/install/ubuntu/. Docker כלול ב-Cloud Shell.
כדי לבצע פעולות במאגרים, Docker דורש גישה עם הרשאות. ב-Linux או ב-Windows, מוסיפים את המשתמש שבאמצעותו מריצים פקודות Docker לקבוצת האבטחה של Docker. לא צריך לבצע את השלב הזה ב-macOS כי Docker Desktop פועל במכונה וירטואלית כמשתמש Root.
ב-Linux, מוסיפים את המשתמש:
sudo usermod -a -G docker USERב-Windows:
net localgroup docker-users DOMAIN\Upan>SER /addמחליפים את
USERבשם המשתמש שרוצים להוסיף.
הגדרת Docker כך שיאשר את ה-Root CA של Harbor
כשמשתמשים בלקוח Docker כדי לתקשר עם המכונה של Harbor, צריך להגדיר את לקוח Docker המקומי כך שיסמוך על ה-CA ברמה הבסיסית (root) של הארגון.
כדי להגדיר את לקוח Docker כך שיסמוך על רשות אישורי הבסיס, בקשו ממנהל המערכת של הארגון את קובץ ה-.crt של רשות אישורי הבסיס, והעתיקו את רשות אישורי הבסיס של הארגון אל:
/etc/docker/certs.d/HARBOR_INSTANCE_URL/ca.crt
מחליפים את HARBOR_INSTANCE_URL בכתובת ה-URL של המכונה של Harbor. לדוגמה, harbor-1.org-1.zone1.google.gdc.test.
הפקודה הזו מאפשרת ללקוח Docker ליצור חיבור HTTPS עם המכונה של Harbor.
לחלופין, אתם יכולים להשתמש ב-CLI של gdcloud כדי להיכנס לארגון, ליצור את קובץ ה-kubeconfig של שרת ה-API לניהול ולהשתמש בו, ולהעתיק את חבילת האמון באשכול. מידע נוסף זמין במאמר אחזור חבילות אמון של GDC.
export REGISTRY=HARBOR_INSTANCE_URL
mkdir -p /etc/docker/certs.d/${REGISTRY} && echo $(kubectl get secret trust-store-global-root-ext -n platform -o \
jsonpath='{.data.ca\.crt}') | openssl base64 -A -d > \
/etc/docker/certs.d/${REGISTRY}/ca.crt
מחליפים את HARBOR_INSTANCE_URL בכתובת ה-URL של המכונה של Harbor. לדוגמה, harbor-1.org-1.zone1.google.gdc.test.
אם ההגדרה נכשלת, מופיעה הודעת השגיאה הבאה:
Error response from daemon: Get "https://<HARBOR_INSTANCE_URL>": x509: certificate signed by unknown authority
חוזרים על השלבים כדי לפתור את הבעיה, ואם צריך, מעבירים את הטיפול לצוות ההנדסה של GDC.
אם פודים באשכול Kubernetes מציגים שגיאת x509: certificate signed by unknown
authority כשהם שולפים תמונות ממכונה של מרשם Harbor, קראו את המאמר פתרון שגיאות של אישורים כששולפים תמונות.
המאמרים הבאים
אחרי שמגדירים את לקוח Docker כך שיסמוך על ה-CA הבסיסי של Harbor, מסיימים את הגדרת החיבור כדי להתחיל להשתמש במרשם: