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

כדי לגשת לחבילות של Assured Open Source Software (Assured OSS) ולהוריד אותן, אתם יכולים להגדיר מאגר מרוחק של JFrog Artifactory או Sonatype Nexus. ההגדרה הזו מאפשרת להוריד חבילות של Assured OSS ולהעביר אותן דרך שרת proxy באמצעות הכלי הקיים לניהול פריטי מידע שנוצרו בתהליך הפיתוח (Artifact). מידע נוסף על אפשרויות המאגר זמין במאמר אפשרויות המאגר של Assured 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. בשדה Registry URL, מזינים את הכתובת הבאה (רק ל-Python): 

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

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

  6. לוחצים על Create Remote Repository.

    בחבילות 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.

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

בעיות מוכרות

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

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

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

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

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

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

      • 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, בוחרים באפשרות Authentication.

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

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

  7. לוחצים על Create Repository.

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

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