הגדרת מכונות וירטואליות להתקנת חבילות Debian

מאגרי Apt ב-Artifact Registry מאפשרים לכם לקבוע אילו גרסאות של חבילות Debian יותקנו במכונות הווירטואליות (VMs). אתם יכולים להגדיר מכונות של Compute Engine או מכונות וירטואליות חיצוניות כדי להתקין חבילות ממאגרים פרטיים או ציבוריים.

לפני שמתחילים

אם מאגר ה-Apt לא קיים, יוצרים מאגר רגיל או מרוחק. אתם יכולים ליצור מאגר פרטי או מאגר ציבורי שלא דורש אימות.

הכנת מכונה וירטואלית לגישה למאגר Apt

מאגר פרטי

  1. בוחרים את חשבון השירות שבו תשתמשו כדי לתת גישה.

    • במכונות וירטואליות של Compute Engine, יכול להיות שזה יהיה חשבון השירות שמוגדר כברירת מחדל. ‫Artifact Registry מאחזר באופן אוטומטי את פרטי הכניסה לחשבון השירות של מכונת ה-VM ב-Compute Engine לכל מכונת VM שמשתמשת בחשבון שירות.
    • במכונות וירטואליות אחרות, יוצרים או בוחרים חשבון שירות שיפעל בשם המכונה הווירטואלית. כדי להגדיר את המכונה הווירטואלית, תצטרכו את המיקום של קובץ המפתח של חשבון השירות. בדף Service Accounts אפשר לראות את המפתחות של החשבונות הקיימים וליצור מפתחות חדשים.
  2. נותנים לחשבון השירות הרשאות גישה למאגר.

  3. מכינים את ה-VM לגישה למאגר.

    מכונה וירטואלית ב-Compute Engine

    ‫VM של Debian

    1. מקצים למכונה הווירטואלית היקפי גישה ל-API של cloud-platform. למידע על הגדרת היקפי גישה, ראו שינוי חשבון השירות והיקפי הגישה של מכונה.

    2. מעדכנים את Apt באמצעות הפקודה הבאה:

      sudo apt update
      
    3. מתקינים את החבילה apt-transport-artifact-registry ב-VM:

      sudo apt install apt-transport-artifact-registry
      

    מכונה וירטואלית של Ubuntu

    1. מתקינים את מפתחות החתימה של מאגר Apt באמצעות הפקודה הבאה:

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/google-cloud-sdk.gpg
      

      מחליפים את LOCATION במיקום האזורי או במספר האזורים של המאגר.

    2. מקצים למכונה הווירטואלית היקפי גישה ל-API של cloud-platform. למידע על הגדרת היקפי גישה, ראו שינוי חשבון השירות והיקפי הגישה של מכונה.

    3. מגדירים את ה-VM כך שתהיה לו גישה לחבילות של Artifact Registry באמצעות הפקודה הבאה:

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
      
    4. מעדכנים את Apt באמצעות הפקודה הבאה:

      sudo apt update
      
    5. מתקינים את החבילה apt-transport-artifact-registry ב-VM:

      sudo apt install apt-transport-artifact-registry
      

    מכונה וירטואלית אחרת

    1. מתקינים את מפתחות החתימה של מאגר Apt באמצעות הפקודה הבאה:

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/google-cloud-sdk.gpg
      

      מחליפים את LOCATION במיקום האזורי או במספר האזורים של המאגר.

    2. מגדירים את ה-VM כך שתהיה לו גישה לחבילות של Artifact Registry באמצעות הפקודה הבאה:

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
      
    3. מעדכנים את Apt באמצעות הפקודה הבאה:

      sudo apt update
      
    4. מתקינים את החבילה apt-transport-artifact-registry ב-VM:

      sudo apt install apt-transport-artifact-registry
      
    5. מוצאים את השורה #Service-Account-JSON "/path/to/creds.json"; בקובץ /etc/apt/apt.conf.d/90artifact-registry, מבטלים את הסימון שלה כהערה ומוסיפים את הנתיב של המפתח של חשבון השירות.

      רשומה בקובץ התצורה:

      Service-Account-JSON  "PATH_TO_SERVICE_ACCOUNT_KEY";
      

      מחליפים את PATH_TO_SERVICE_ACCOUNT_KEY בנתיב לקובץ ה-JSON של מפתח חשבון השירות.

מאגר ציבורי

  1. מגדירים גישה ציבורית למאגר.

  2. אם אתם מגדירים מכונה וירטואלית מחוץ ל- Google Cloud, הכינו את המכונה לגישה למאגר. אם אתם מגדירים מכונה וירטואלית של Compute Engine, המשיכו לשלב הבא.

    מתקינים את מפתח האימות הציבורי של החתימה באמצעות הפקודה הבאה:

    curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg
    

    מחליפים את LOCATION במיקום האזורי או במספר האזורים של המאגר.

  3. מעדכנים את Apt באמצעות הפקודה הבאה:

    sudo apt update
    

הגדרת VM לגישה למאגר Apt רגיל

הגדרת מכונה וירטואלית כדי לגשת למאגר Apt:

  1. מריצים את הפקודה gcloud beta artifacts print-settings apt כדי ליצור את פקודת ההגדרה של המכונה הווירטואלית:

    gcloud beta artifacts print-settings apt \
        --repository=REPOSITORY \
        --location=LOCATION
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫ LOCATION הוא המיקום של המאגר באזור או במספר אזורים. ‫
    • ‫REPOSITORY הוא השם של מאגר Artifact Registry.

    הפלט אמור להיראות כך:

    # To configure your package manager with this repository:
    
    # Update Apt:
    sudo apt update
    
    # Install the Apt credential helper:
    sudo apt install apt-transport-artifact-registry
    
    # Configure your VM to access Artifact Registry packages using the following
    # command:
    
    echo "deb [signed-by=/etc/apt/trusted.gpg.d/artifact-registry.gpg] ar+https://LOCATION-apt.pkg.dev/projects/PROJECT REPOSITORY main" | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
    
    # Update Apt:
    sudo apt update
    
  2. מגדירים את Apt לאחזור חבילות מהמאגר באמצעות הפקודה echo מהפלט של הפקודה print-settings.

    לדוגמה, כדי להתקין חבילות מהמאגר הציבורי my-repo בפרויקט my-project ובמיקום us-west1, משתמשים בפקודה הבאה:

    echo 'deb ar+https://us-west1-apt.pkg.dev/projects/my-project my-repo main'
    
  3. מעדכנים את מקורות המאגר באמצעות הפקודה הבאה:

    sudo apt update
    

עכשיו Apt יכול להתחבר למאגר.

אם אתם יוצרים מאגרי Apt נוספים, אתם יכולים להוסיף אותם לקובץ artifact-registry.list ואז להריץ מחדש את sudo apt update כדי לעדכן את מקורות המאגר.

הגדרת VM לגישה למאגר Apt מרוחק

כדי להגדיר מכונה וירטואלית כך שתשתמש רק במאגר Apt מרוחק במקום במאגר Apt רגיל, מחליפים את המאגר הרגיל במאגר המרוחק בקובץ /etc/apt/sources.list של המכונה הווירטואלית.

  1. נותנים לחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine הרשאות כתיבה ב-Artifact Registry ברמת הפרויקט:

     gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
       --role=roles/artifactregistry.writer
    
  2. נכנסים לדף VM instances.

  3. בשורה של המכונה הווירטואלית, לוחצים על SSH.

    ייפתח חלון חדש עם סשן טרמינל במכונה הווירטואלית.

  4. פותחים את הקובץ /etc/apt/sources.list של המכונה הווירטואלית ומאתרים את המאגר הרגיל שרוצים להחליף במאגר המרוחק החדש.

  5. מוחקים את שורת המאגר הרגילה ומחליפים אותה בשורה הבאה:

    deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫LOCATION במיקום האזורי או במספר האזורים של המאגר המרוחק.
    • ‫PROJECT_ID במזהה הפרויקט של ה-VM.
    • ‫REMOTE_REPOSITORY_NAME בשם שנתתם למאגר המרוחק.
    • ‫UPSTREAM_REPOSITORY_NAME בשם של המאגר במעלה הזרם של המאגר המרוחק.
    • ‫COMPONENTS ברשימה של שמות רכיבים שמופרדים ברווחים.

    לדוגמה, ההגדרה הבאה קובעת שה-VM יאחזר חבילות מהמאגר my-repo בפרויקט my-project במיקום us-east1, באמצעות stable כמאגר במעלה הזרם לרכיבים main, contrib ו-non-free.

    deb ar+https://us-east1-apt.pkg.dev/remote/my-project/my-repo stable main contrib non-free
    
  6. מעדכנים את מקורות המאגר באמצעות הפקודה הבאה:

    sudo apt update
    

    עכשיו Apt יכול להתחבר למאגר.

שימוש במאגר Apt מרוחק כגיבוי

אם אתם רוצים להשאיר את המאגר הסטנדרטי במעלה הזרם כאפשרות הראשונה ולהוסיף את המאגר המרוחק כאפשרות חלופית, אתם יכולים להשאיר את המאגר הסטנדרטי במעלה הזרם בקובץ sources.list, ולהוסיף את המאגר המרוחק בסוף הקובץ sources.list או ליצור רשימה חדשה בתיקייה sources.list.d.

כדי ליצור קובץ artifact-registry.list חדש בתיקייה sources.list.d, מריצים את הפקודה הבאה:

echo 'deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ LOCATION הוא המיקום של המאגר באזור או במספר אזורים. ‫
  • ‫PROJECT_ID במזהה הפרויקט של ה-VM.
  • REMOTE_REPOSITORY_NAME בשם שנתתם למאגר המרוחק.
  • ‫UPSTREAM_REPOSITORY_NAME בשם של המאגר במעלה הזרם של המאגר המרוחק.
  • ‫COMPONENTS ברשימה של שמות רכיבים שמופרדים ברווחים.

אם אתם יוצרים מאגרי Apt נוספים, אתם יכולים להוסיף אותם לקובץ artifact-registry.list או sources.list ואז להריץ מחדש את sudo apt update כדי לעדכן את מקורות המאגר.

הגדרת גישת HTTP למאגר Apt

אם אתם משתמשים בכלים ישנים יותר של לקוחות שלא תומכים בהצפנת SSL, אתם יכולים להגדיר גישה ציבורית למאגר Apt ולגשת אליו באמצעות HTTP. בקשות שנשלחות למאגרים ציבוריים שניתנים לקריאה באמצעות HTTP יידחו אם יוצג אסימון אימות עם הבקשה.

  1. מגדירים גישה ציבורית למאגר.

  2. כדי להגדיר ל-Apt לאחזר חבילות מהמאגר באמצעות HTTP, מריצים את הפקודה הבאה:

     echo 'deb http://LOCATION-apt.pkg.dev/projects/PROJECT_ID \
     REPOSITORY main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫ LOCATION הוא המיקום של המאגר באזור או במספר אזורים. ‫
    • ‫PROJECT_ID הוא מזהה הפרויקט של המאגר.
    • ‫REPOSITORY הוא שם המאגר.

    לדוגמה, כדי להתקין חבילות מהמאגר הציבורי my-repo בפרויקט my-project ובמיקום us-west1 באמצעות HTTP, משתמשים בפקודה הבאה:

    echo 'deb http://us-west1-apt.pkg.dev/projects/my-project my-repo main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
    
  3. מעדכנים את מקורות המאגר באמצעות הפקודה הבאה:

    sudo apt update
    

עכשיו Apt יכול להתחבר למאגר.

אם אתם יוצרים מאגרי Apt נוספים, אתם יכולים להוסיף אותם לקובץ artifact-registry.list ואז להריץ מחדש את sudo apt update כדי לעדכן את מקורות המאגר.

המאמרים הבאים