Konfigurieren der Installation aus dem Artifactory-Repository

Artifactory®, veröffentlicht von JFrog®, ist ein Artefakt-Repository-Manager mit Unterstützung für Versionsverwaltung, Zugriffskontrolle und CI/CD-Integration. Das Befehlszeilentool MATLAB® Package Manager (mpm) ermöglicht es Benutzern, MathWorks® Produkte aus dem Artifactory-Repository Ihrer Organisation herunterzuladen und zu installieren. In diesem Thema wird erläutert, wie Sie die Installation aus dem Artifactory-Repository Ihrer Organisation nur von MathWorks Produkten durchführen. (Die Installation von Supportpaketen aus Artifactory-Repositories wird aktuell nicht unterstützt.)

Workflow der Installationskonfiguration

Um die Installation von MathWorks Produkten aus dem Artifactory-Repository Ihrer Organisation zu konfigurieren:

  1. Richten Sie die Repository-Ordnerstruktur ein und erstellen Sie die JSON-Konfigurationsdatei, die zur Installation von Produkten aus dem Repository benötigt wird (einmaliger Schritt).

  2. Laden Sie Produkte mithilfe von mpm download von MathWorks herunter.

  3. Laden Sie die Produkte in das Artifactory-Repository Ihrer Organisation hoch.

Three steps for configuring installation from your organization's repository

Wiederholen Sie die Schritte 2 und 3 für jede neue Version oder Aktualisierung von MathWorks Produkten.

Benutzer können daraufhin mithilfe von mpm install und der Konfigurationsdatei Produkte aus dem Repository installieren.

A computer receives an installation of MATLAB from a repository using mpm install and the JSON configuration file.

Einrichten des Repository und Erstellen der Konfigurationsdatei (einmaliger Schritt)

An Artifactory repository with a folder hierarchy and JSON configuration file

Führen Sie die einmaligen Schritte durch, die zum Installieren von Produkten aus Artifactory erforderlich sind: Das Einrichten des Repository und

Einrichten des Repository

Richten Sie das Artifactory-Repository ein, in dem MathWorks Produkte gespeichert werden sollen.

  1. Erstellen Sie in Artifactory ein neues Repository oder verwenden Sie ein bestehendes Repository. In beiden Fällen muss der Typ des Repository auf Generic gesetzt werden. Beispiel-URL des Repository:

    http://artifactory.example.com/artifactory/my-repo

  2. Erstellen Sie im Stammverzeichnis Ihres Artifactory-Repository einen Unterordner namens MathWorks, in dem die MathWorks Versionen gespeichert werden sollen. Beispiel-Ordnerstruktur:

    MathWorks/

    Später werden Sie die von MathWorks heruntergeladenen Produktversionen in den Unterordner MathWorks hochladen. Jede Produktversion und Aktualisierung wird in einem eigenen Unterordner des Ordners MathWorks gespeichert (beispielsweise R20XXaU0, R20XXaU1 und so weiter). Die Beispiel-Ordnerstruktur stellt ein Repository mit mehreren hochgeladenen Versionen und Aktualisierungen dar:

      MathWorks/
    R20XXaU0/
    R20XXaU1/
    R20XXaU2/
    ...
    R20XXbU0/
    R20XXbU1/
    R20XXbU2/
    ...

Erstellen einer Konfigurationsdatei

Erstellen Sie die JSON-Konfigurationsdatei, mit der Benutzer die Produkte installieren können. Diese Datei enthält Informationen über das für die Installation benötigte Repository.

  1. Erstellen Sie eine JSON-Datei. Beispiel: my_repo_config.json.

  2. Kopieren Sie die folgenden Inhalte in die JSON-Datei:

    {
  "repository_configuration": [
    {
      "name": "my-repo",
      "url": "https://my-artifactory-instance/my-repo",
      "type": "artifactory",
      "repository_layout": {
        "mathworks_products": "MathWorks"
      },
      "auth": {
        "type": "token",
        "access_token": "${ARTIFACTORY_ACCESS_TOKEN}"
      }
    }
  ]
}

  3. Modifizieren Sie die JSON-Dateifelder für Ihr Repository.

    • "name" – Name Ihres Artifactory-Repository.

    • "url" – URL Ihres Artifactory-Repository.

    • "type" – Typ des Repository. Aktuell ist "artifactory" der einzige unterstützte Repository-Typ.

    • "repository_layout" – Ordner-Anordnung Ihres Artifactory-Repository. Jedes Unterfeld in repository_layout definiert einen Unterordner, in dem installierbare MathWorks Software gespeichert ist. Unterstützte Unterfelder:

      • "mathworks_products" – Name des Unterordners mit MathWorks Produktversionen. Nehmen wir beispielsweise an, dass Ihre Konfigurationsdatei diese Feldwerte enthält:

        ...
"url": "https://my-artifactory-instance/my-repo",
...
"repository_layout": {
  "mathworks_products": "MathWorks"
},
...
        Wenn Sie Produkte für R2026aU0 installieren, sucht mpm unter der folgenden URL nach Produkten:

        https://my-artifactory-instance/my-repo/MathWorks/R2026aU0

    • "auth" – Authentifizierungsdaten für den Zugriff auf das Repository. Unterstützte Unterfelder:

      • "type" – Authentifizierungstyp. Aktuell ist "token" der einzige unterstützte Typ.

      • "access_token" – Token zur Authentifizierung von Benutzern, die auf das Repository zugreifen. Haben Sie vom IT-Administrator ein Zugangstoken erhalten, setzen Sie das Token in der Umgebungsvariable ARTIFACTORY_ACCESS_TOKEN. Befolgen Sie das Verfahren Ihrer Organisation zum Festlegen von Umgebungsvariablen. Beispiel-Syntax:

        ARTIFACTORY_ACCESS_TOKEN=abc123xyz456

        Geben Sie daraufhin in der JSON-Datei den Namen der Umgebungsvariable im Feld access_token gemäß der folgenden Syntax an:

        "access_token": "${ARTIFACTORY_ACCESS_TOKEN}"

        Alternativ können Sie das Zugangstoken direkt in der JSON-Datei angeben, statt eine Umgebungsvariable zu setzen. Beispiel:

        "access_token": "abc123xyz456"

  4. Speichern Sie die JSON-Datei an einem Speicherort, auf den Benutzer Zugriff haben, wie beispielsweise ein freigegebenes Netzlaufwerk. Wenn Benutzer Dateien aus Ihrem Artifactory-Repository herunterladen können, können Sie die Datei auch im Artifactory-Repository speichern.

Herunterladen von Produkten

A folder being downloaded from a MathWorks web server

Verwenden Sie mpm, um die Produkte für eine bestimmte Version herunterzuladen, die Sie bei Artifactory hochladen möchten. Sie können keine aus anderen Quellen (wie z. B. ISO- oder DMG-Images) heruntergeladenen Produkte hochladen.

  1. Laden Sie die aktuelle Version von mpm herunter, indem Sie die Anweisungen unter Get MATLAB Package Manager (Herunterladen des MATLAB Package Managers) befolgen.

  2. Laden Sie Produkte mithilfe von mpm download herunter. Laden Sie beispielsweise die erste Version (Aktualisierung 0) von Simulink® und Deep Learning Toolbox™ R2026a für die Linux®- (glnxa64) und Windows-Plattformen (win64) herunter. Ersetzen Sie <USER> durch den Benutzernamen Ihres Computers. mpm lädt ebenfalls das erforderliche Produkt MATLAB herunter.

    Linux oder Mac:

    ./mpm download --release=R2026aU0 --destination=/home/<USER>/Downloads/R2026aU0 --platforms=glnxa64 win64 --products=Simulink Deep_Learning_Toolbox

    Windows®:

    .\mpm.exe download --release=R2026aU0 --destination=C:\Users\<USER>\Downloads\R2026aU0 --platforms=glnxa64 win64 --products=Simulink Deep_Learning_Toolbox

    Wenn Sie eine große Anzahl Produkte herunterladen möchten, können Sie die Produkte mithilfe der Option --inputfile in einer Eingabedatei angeben. Weitere Informationen finden Sie im Beispiel Herunterladen von Produkten mithilfe einer Eingabedatei auf der Referenzseite mpm download.

Der Ordner R2026aU0 weist die folgende Struktur auf:

R2026aU0/
  archives/
  mpm/
  ProductFilesInfo.xml

Der Ordner R2026aU0 enthält die folgenden Dateien und Unterordner:

  • archives – Unterordner mit den heruntergeladenen Produkten.

  • mpm – Unterordner mit den heruntergeladenen Versionen von mpm, eine pro Plattform, die Sie über die Option --platforms von mpm angegeben haben. Ihre Benutzer können Produkte mithilfe dieser Versionen von mpm installieren, wie in dieser Beispielstruktur veranschaulicht:

    mpm/
  glnxa64/
    mpm
  win64/
    mpm.exe

  • ProductFilesInfo.xml – Metadaten-Datei mit Informationen über das Produkt.

Hochladen von Produkten bei Artifactory

A folder being uploaded to an Artifactory repo

Laden Sie die im vorherigen Abschnitt heruntergeladenen Produkte bei Artifactory hoch. Da Artifactory kein Hochladen von Ordnern unterstützt, müssen Sie den heruntergeladenen Ordner zunächst zu einer ZIP-Datei komprimieren. Verändern Sie die Struktur oder Inhalte dieses Ordners nicht, bevor Sie ihn komprimieren und hochladen.

  1. Komprimieren Sie den heruntergeladenen Versionsordner mit Ihrem bevorzugten Tool zu einer ZIP-Datei. Navigieren Sie beispielsweise zum heruntergeladenen Ordner und verwenden Sie zip (Linux oder Mac) oder tar (Windows), um dessen Inhalte zu einer ZIP-Datei im übergeordneten Ordner Downloads zu komprimieren.

    Linux oder Mac:

    cd /home/<USER>/Downloads/R2026aU0
zip -r ../R2026aU0.zip ./*
cd ..

    Windows (Befehlszeile):

    cd C:\Users\<USER>\Downloads\R2026aU0
tar -a -c -f ..\R2026aU0.zip *
cd ..

    Je nach der Anzahl heruntergeladener Produkte kann dieser Prozess mehrere Minuten in Anspruch nehmen. Die komprimierte ZIP-Datei sollte die in diesem Beispiel dargestellten Unterordner und die Datei enthalten.

    R2026aU0.zip
  archives/
  mpm/
  ProductFilesInfo.xml

  2. Erstellen Sie im Ordner MathWorks Ihres Artifactory-Repository einen Unterordner, in den Sie die ZIP-Datei hochladen möchten. Um diesen Unterordner zu erstellen, verwenden Sie die JFrog Befehlszeile oder Ihr bevorzugtes Tool. Das folgende Beispiel stellt dar, wie Sie den Ordner mithilfe von curl erstellen, einem Befehlszeilen-REST-API für HTTPS-Webanfragen.

    Linux oder Mac:

    curl --user <USER>:<PASSWORD> \
     --request PUT \
     "https://my-artifactory-instance/my-repo/MathWorks/R2026aU0/"

    Windows (Befehlszeile):

    curl --user <USER>:<PASSWORD> ^
     --request PUT ^
     "https://my-artifactory-instance/my-repo/MathWorks/R2026aU0/"

    Der Befehl curl umfasst diese Optionen:

    • --user <USER>:<PASSWORD> – Geben Sie Ihren Benutzernamen und Ihr Artifactory-Passwort an. Alternativ, wenn Sie ein Zugangstoken verwenden, ersetzen Sie --user <USER>:<PASSWORD> durch den folgenden zusätzlichen Header: --header "Authorization: Bearer <TOKEN>"

    • --request PUT – Verwenden Sie eine PUT-Anfrage, da der Upload das Repository verändert.

    • https://my-artifactory-instance/my-repo/MathWorks/R2026aU0/ – Geben Sie den URL-Endpunkt des Ordners an, wie er in Artifactory angezeigt wird. Fügen Sie der URL einen nachgestellten Schrägstrich hinzu. Verwenden Sie das folgende URL-Format:

      https://my-artifactory-instance/my-repo/MathWorks/R20XXyUn/

      • https://my-artifactory-instance/my-repo/ ist die URL Ihres Artifactory-Repository, festgelegt durch das Feld "url" in Ihrer Repository-Konfigurationsdatei.

      • MathWorks/ ist der Unterordner, in dem die MathWorks Produktversionen gespeichert werden, festgelegt durch das Unterfeld "mathworks_products" im Feld "repository_layout" in Ihrer Repository-Konfigurationsdatei.

      • R20XXyUn/ ist ein Produktversion-Ordner, wobei R20XXy für den Versionsnamen (beispielsweise R2026a) und Un für die Versionsnummer der Aktualisierung steht (beispielsweise U0, U1 und so weiter).

  3. Laden Sie die ZIP-Datei in den Produktversion-Ordner hoch, den Sie soeben in Ihrem Artifactory-Repository erstellt haben. Verwenden Sie die JFrog Befehlszeile oder Ihr bevorzugtes Tool. Das folgende Beispiel stellt dar, wie Sie die ZIP-Datei mithilfe von curl hochladen.

    Linux oder Mac:

    curl --user <USER>:<PASSWORD> \
     --header "X-Explode-Archive:true" \
     --request PUT \
     --upload-file /home/<USER>/downloads/R2026aU0.zip \
     "https://my-artifactory-instance/my-repo/MathWorks/R2026aU0/"

    Windows (Befehlszeile):

    curl --user <USER>:<PASSWORD> ^
     --header "X-Explode-Archive:true" ^
     --request PUT ^
     --upload-file "C:\Users\<USER>\Downloads\R2026aU0.zip" ^
     "https://my-artifactory-inpinstance/my-repo/MathWorks/R2026aU0/"

    Der Befehl curl umfasst diese Optionen:

    • --user <USER>:<PASSWORD> – Geben Sie Ihren Benutzernamen und Ihr Artifactory-Passwort an. Alternativ, wenn Sie ein Zugangstoken verwenden, ersetzen Sie --user <USER>:<PASSWORD> durch den folgenden zusätzlichen Header: --header "Authorization: Bearer <TOKEN>"

    • --header "X-Explode-Archive:true" – Geben Sie im Anfrage-Header X-Explode-Archive:true an, um den Ordner nach dem Hochladen zu dekomprimieren.

    • --request PUT – Verwenden Sie eine PUT-Anfrage, da der Upload das Repository verändert.

    • --upload-file ... – Geben Sie den Pfad zur ZIP-Datei an.

    • https://my-artifactory-instance/my-repo/MathWorks/R2026aU0/ – Geben Sie den URL-Endpunkt des im vorherigen Schritt erstellten Ordners an.

Installieren von Produkten aus Artifactory

A computer receives an installation of MATLAB from a repository using mpm install and the JSON configuration file.

Damit Ihre Benutzer Produkte aus Ihrem Artifactory-Repository installieren können, benötigen sie Folgendes:

  • Eine Kopie der Repository-Konfigurationsdatei (beispielsweise my_repo_config.json).

  • Eine mit der Plattform kompatible Version von mpm. Benutzer können entweder die Kopie von mpm herunterladen, die in das Repository hochgeladen wurde, oder mpm von den MathWorks Webservern herunterladen. Anweisungen hierfür finden Sie unter Get MATLAB Package Manager (Herunterladen des MATLAB Package Managers).

Dieser Beispielbefehl für mpm install installiert die Produkte aus dem Artifactory-Repository und verwendet hierbei eine an einem freigegebenen Speicherort gespeicherte Konfigurationsdatei.

Linux oder Mac:

./mpm install --repo-config=/usr/share/my_repo_config.json --release=R2026aU0 --destination=/home/<USER>/matlab --products=Simulink Deep_Learning_Toolbox

Windows (als Administrator ausführen):

.\mpm.exe install --repo-config="Z:\share\my_repo_config.json" --release=R2026aU0 --destination="C:\Users\<USER>\matlab" --products=Simulink Deep_Learning_Toolbox

Wenn Sie eine große Anzahl Produkte installieren möchten, können Sie die Produkte mithilfe der Option --inputfile in einer Eingabedatei angeben. Weitere Informationen finden Sie im Beispiel Installieren von Produkten aus einem Artifactory Repository mithilfe einer Eingabedatei auf der Referenzseite mpm install.

Benutzer können zudem mpm in einer Dockerfile verwenden, um MATLAB in CI/CD-Pipelines zu integrieren. Ein Beispiel finden Sie unter Create a MATLAB Container Image (Erstellen eines MATLAB-Container-Image) auf GitHub®.

Siehe auch

|

Themen