הורדת חבילות Assured OSS באמצעות מאגר מרוחק

בדף הזה מוסבר איך להגדיר מאגר מרוחק כדי לגשת לחבילות Assured OSS ולהוריד אותן. יש שתי אפשרויות להגדרת מאגר מרוחק: JFrog Artifactory או Sonatype Nexus. מידע נוסף על אפשרויות המאגר זמין במאמר אפשרויות מאגר OSS מאומת.

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

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

  1. הפעלת Assured OSS.

  2. מאמתים את הקישוריות ל-Assured OSS עבור חשבונות השירות המבוקשים.

הגדרת מאגר מרוחק באמצעות JFrog Artifactory

  1. נכנסים למנהל המאגר של JFrog Artifactory. מוודאים שיש לכם את ההרשאות הנדרשות ליצירת מאגר מרוחק חדש.
  2. בוחרים באפשרות ליצור מאגר חדש של מאגרים מרוחקים במנהל המאגרים.
  3. בוחרים את סוג המאגר המתאים (לדוגמה, בוחרים באפשרות Maven ל-Java, באפשרות PyPi ל-Python או באפשרות Go ל-Go).

  4. אפשר גם לבדוק את החיבור למאגר Java או Python באמצעות השלבים הבאים:

    1. בשדה Repository Key (מפתח המאגר), מזינים שם ייחודי או מזהה למאגר המרוחק.

    2. בשדה כתובת URL, מזינים אחת מהאפשרויות הבאות:

      • ‫Java: 
        https://us-maven.pkg.dev
      • ‫Python: 
        https://us-python.pkg.dev
      • ‫JavaScript: 
        https://us-npm.pkg.dev
      • עוברים אל: 
        https://us-go.pkg.dev

      אל תזינו את שם הדומיין המלא כי הפעולה הזו עשויה להחזיר קוד מצב HTTP 404 או HTTP 405.

    3. משאירים את שאר השדות ריקים.

    4. לוחצים על בדיקה. החיבור מצליח כשמופיע הפלט הבא:

      Successfully connected to server

  5. כדי ליצור מאגר מרוחק חדש, מזינים את הפרטים הבאים:

    1. בשדה Repository Key (מפתח המאגר), מזינים שם ייחודי או מזהה של המאגר המרוחק. לדוגמה, assured-oss-java-repo.

    2. בשדה כתובת URL, מזינים אחת מהאפשרויות הבאות:

      • ‫Java: 
        https://us-maven.pkg.dev/cloud-aoss/java
      • ‫Python: 
        https://us-python.pkg.dev/cloud-aoss/python
      • עוברים אל: 
        https://us-go.pkg.dev/cloud-aoss/go

    3. בשדה שם משתמש, מזינים _json_key_base64.

    4. בשדה Password, מציינים את המחרוזת בקידוד base64 של קובץ מפתח ה-JSON של חשבון השירות. משתמשים בכל המחרוזת המקודדת בפורמט Base64 בשורה אחת כסיסמה. כדי לקבל את המחרוזת בקידוד Base64, מריצים את הפקודה cat key-filename.json | base64.

    5. ב-Python בלבד, בשדה כתובת URL של המאגר מזינים: 

      https://us-python.pkg.dev/cloud-aoss/python
       בשדה כתובת URL מזינים: 
      https://us-python.pkg.dev

    6. ב-Go בלבד, בכרטיסייה הגדרות מתקדמות, בוחרים באפשרות דילוג על בקשות HEAD.

  6. לוחצים על יצירת מאגר מרוחק.

    עבור חבילות Python, מוסיפים את /simple לכתובת ה-URL שהתקבלה. משתמשים בכתובת ה-URL כ-index-url בפקודה pip install כדי להוריד את חבילות Python הנדרשות. לדוגמה, אם כתובת ה-URL של המאגר היא https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo, אז index-url המתאים הוא https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple.

אחרי שמגדירים את המאגר המרוחק החדש, צריך להגדיר את כלי הבנייה (לדוגמה, Apache Maven,‏ Gradle Build Tool או pip) לשימוש במאגר המרוחק החדש הזה.

בעיות מוכרות

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

הגדרת מאגר מרוחק באמצעות Sonatype Nexus

  1. נכנסים למנהל המאגר של Sonatype Nexus. מוודאים שיש לכם את ההרשאות הנדרשות ליצירת מאגר מרוחק חדש.
  2. בוחרים באפשרות ליצירת מאגר חדש.
  3. בוחרים את סוג המאגר המתאים (לדוגמה, בוחרים באפשרות Maven ל-Java, באפשרות PyPi ל-Python או באפשרות Go ל-Go).

  4. מזינים את הפרטים הבאים של המאגר החדש:

    1. בשדה שם, מזינים שם ייחודי או מזהה למאגר המרוחק.

    2. בשדה Remote Storage (אחסון מרחוק), בוחרים באחת מהאפשרויות הבאות:

      • ‫Java: 

        https://us-maven.pkg.dev/cloud-aoss/java

      • ‫Python: 

        https://us-python.pkg.dev/cloud-aoss/python

      • עוברים אל: 

        https://us-go.pkg.dev/cloud-aoss/go

  5. בקטע HTTP, בוחרים באפשרות אימות.

  6. מציינים את הפרטים הבאים:

    1. בשדה Authentication type (סוג אימות), מזינים Username.
    2. בשדה שם משתמש, מזינים _json_key_base64.
    3. בשדה Password, מציינים את המחרוזת בקידוד base64 של קובץ מפתח ה-JSON של חשבון השירות. משתמשים בכל המחרוזת המקודדת ב-Base64 בשורה אחת כסיסמה. כדי לקבל את המחרוזת בקידוד Base64, מריצים את הפקודה cat key-filename.json | base64.

  7. לוחצים על Create Repository (יצירת מאגר).

אחרי שמגדירים את המאגר המרוחק החדש, צריך להגדיר את כלי הבנייה (לדוגמה, Apache Maven,‏ Gradle Build Tool או pip) כך שישתמשו במאגר המרוחק החדש הזה.

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