Artifactory konfigurieren
Konfigurieren Sie den Repository-Manager von Artifactory zum Speichern von Buildartefakten in Ihrem Artifactory-Repository (Repo).
-
Wenn Sie diese Toolintegration konfigurieren, während Sie die Toolchain erstellen, klicken Sie im Abschnitt mit den konfigurierbaren Integrationen auf Artifactory.
-
Wenn Sie eine Toolchain haben und diese Toolintegration hinzufügen möchten, klicken Sie in der IBM Cloud auf das
im Menü > Plattformautomatisierung > Toolchains. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen. Alternativ können Sie auf der Übersichtsseite Ihrer App auf der Karte für Continuous Delivery auf Toolchain anzeigen klicken. Klicken Sie anschließend auf Übersicht.
a. Klicken Sie auf Tool hinzufügen.
b. Klicken Sie im Abschnitt mit den Toolintegrationen auf Artifactory.
-
Geben Sie die URL für das Artifactory-Repository (Repo) ein, das geöffnet werden soll, wenn Sie auf die Karte für Artifactory klicken.
-
Wählen Sie den Repository-Typ aus, zu dem eine Verbindung hergestellt werden soll.
-
Wenn Sie eine Artifactory-npm-Registry verwenden, führen Sie die folgenden Schritte aus:
a. Geben Sie die E-Mail-Adresse ein, die Ihrer Registry zugeordnet ist.
b. Geben Sie das Authentifizierungstoken ein, das Ihrer Registry zugeordnet ist.
c. Geben Sie die URL für Ihr Artifactory-Release-Repository ein. Dieses Repository ist Ihre private Registry auf dem Artifactory-Server.
d. Geben Sie die URL für die Spiegelregistry oder die öffentliche Registry ein, die Sie verwenden, um mehrere öffentliche und private npm-Registrys miteinander zu kombinieren. Bei dieser URL kann es sich beispielsweise um die URL der virtuellen Registry auf Ihrem Artifactory-Server handeln, die sowohl auf Ihre private Registry als auch auf einen Cachespeicher der globalen npm-Registry Zugriff hat.
-
Wenn Sie eine Artifactory-Maven-Registry verwenden, führen Sie die folgenden Schritte aus:
a. Geben Sie die Benutzer-ID ein, die Ihrem Repository zugeordnet ist.
b. Geben Sie das Kennwort ein, das Ihrem Repository zugeordnet ist.
c. Geben Sie die URL für Ihr Artifactory-Release-Repository ein. Dieses Repository ist Ihr privates Release-Repository auf dem Artifactory-Server.
d. Geben Sie die URL für Ihr Artifactory-Snapshot-Repository ein. Dieses Repository ist Ihr privates Snapshot-Repository auf dem Artifactory-Server.
e. Geben Sie die URL für das Spiegelrepository oder das öffentliche Repository ein, das Sie verwenden, um mehrere öffentliche und private Maven-Repositorys miteinander zu kombinieren. Bei dieser URL kann es sich beispielsweise um die URL des virtuellen Repositorys auf Ihrem Artifactory-Server handeln, das sowohl auf Ihre privaten Repositorys als auch auf einen Cachespeicher des zentralen Maven-Repositorys Zugriff hat.
-
Klicken Sie auf Integration erstellen.
-
Klicken Sie auf der Karte Tools anderer Anbieter auf die Artifactory-Toolintegration für das Artifactory-Repository, mit dem Sie arbeiten möchten. Daraufhin wird die Artifactory-Website geöffnet, auf der Sie den Inhalt des Repositorys anzeigen können.
-
Optional: Wenn Sie eine Toolchain unter IBM Cloud Public verwenden und Sie Ihre App unter Verwendung von Artifactory mit npm erstellen wollen, konfigurieren Sie Ihre Pipeline durch Hinzufügen eines npm-Buildjobs. Anweisungen zum Konfigurieren des Buildjobs enthält der Abschnitt Artifactory-npm-Buildjob in Ihrer Pipeline konfigurieren.
-
Optional: Wenn Sie eine Toolchain unter IBM Cloud Public verwenden und Sie Ihre App unter Verwendung von Artifactory mit Maven erstellen wollen, konfigurieren Sie Ihre Pipeline durch Hinzufügen eines Maven-Buildjobs. Anweisungen zum Konfigurieren des Buildjobs enthält der Abschnitt Artifactory-Maven-Buildjob in Ihrer Pipeline konfigurieren.
Artifactory-npm-Buildjob in Ihrer Pipeline konfigurieren
Bevor Sie einen npm-Buildjob in Ihrer Pipeline konfigurieren, müssen Sie über eine funktionstüchtige Pipeline verfügen, die Ihr SCM-Build-Repository als Eingabe verwenden kann. Außerdem müssen Sie Artifactory für Ihre Toolchain konfigurieren. Anweisungen zum Konfigurieren von Artifactory enthält der Abschnitt Artifactory.
Konfigurieren Sie Delivery Pipeline durch Hinzufügen eines npm-Buildjobs. Gehen Sie dazu wie folgt vor:
-
Erstellen Sie eine Phase und geben Sie das entsprechende SCM-Repository für die Eingabe an.
-
Fügen Sie in der Phase einen Buildjob hinzu.
-
Konfigurieren Sie den Build-Job:
build a. Wählen Sie als Buildertyp den Typ NPM-Build aus.
b. Falls Sie mehrere Instanzen der Artifactory-Toolintegration konfiguriert haben, geben Sie den Namen der Artifactory-Toolintegration ein, für die Sie den npm-Buildjob konfigurieren wollen.
c. Wählen Sie als Toolintegrationstyp den Typ Artifactory aus.
d. Geben Sie beim Buildbefehl die Befehle zum Erstellen Ihres npm-Moduls ein oder die Befehle zum Veröffentlichen des Moduls in Ihrer Registry. Das nachfolgende Beispiel zeigt die Befehle zum Erstellen (Builden) des Moduls bzw. zum Veröffentlichen.
npm install # or npm publish --registry "${NPM_RELEASE_URL}"
Sie finden die URL und die Benutzerberechtigungsnachweise, die Sie für die Verbindungsherstellung mit Ihrer Registry verwendet haben, in den Konfigurationseinstellungen für die Artifactory-Toolintegration.
e. Wenn Ihr Buildjob in der Artifactory-Registry veröffentlicht wird und die Version Ihres Knotenmoduls das Format
x.y.z-SNAPSHOT.w
aufweist, wählen Sie das Kontrollkästchen Versionsangabe für Snapshot-Modul inkrementieren aus. Der Buildjob aktualisiert die Modulversion automatisch, bevor er die Veröffentlichung in der Artifactory-Registry ausführt. Der Job wählt die höchste Version des Moduls aus der npm-Registry und der lokalenpackage.json
-Datei aus und erhöht den Wert für die Modulversion unter Verwendung von SemVer (Semantic Versioning). Der Buildjob übermittelt die Änderungen nicht an das SCM-Repository. -
Klicken Sie auf SPEICHERN. Wann immer Ihre Pipeline ausgeführt wird, verwendet dieser Buildjob die Konfigurationsinformationen aus der Artifactory-Toolintegration, um eine Verbindung zu Ihrer npm-Registry herzustellen.
Artifactory-Maven-Buildjob in Ihrer Pipeline konfigurieren
Bevor Sie einen Maven-Buildjob in Ihrer Pipeline konfigurieren, müssen Sie über eine funktionstüchtige Pipeline verfügen, die Ihr SCM-Build-Repository als Eingabe verwenden kann. Außerdem müssen Sie Artifactory für Ihre Toolchain konfigurieren. Anweisungen zum Konfigurieren von Artifactory enthält der Abschnitt Artifactory.
Konfigurieren Sie Delivery Pipeline durch Hinzufügen eines Maven-Buildjobs. Gehen Sie dazu wie folgt vor:
-
Erstellen Sie eine Phase und geben Sie das entsprechende SCM-Repository für die Eingabe an.
-
Fügen Sie in der Phase einen Buildjob hinzu.
-
Konfigurieren Sie den Build-Job:
Maven build job a. Wählen Sie als Buildertyp den Typ Maven-Build aus.
b. Falls Sie mehrere Instanzen der Artifactory-Toolintegration konfiguriert haben, geben Sie den Namen der Artifactory-Toolintegration ein, für die Sie den Maven-Buildjob konfigurieren wollen.
c. Wählen Sie als Toolintegrationstyp den Typ Artifactory aus.
d. Geben Sie beim Buildbefehl die Befehle zum Erstellen Ihres Maven-Moduls ein oder die Befehle zum Veröffentlichen des Moduls in Ihrer Registry. Das nachfolgende Beispiel zeigt die Befehle zum Erstellen (Builden) bzw. zum Veröffentlichen des Moduls in einer Snapshot-Registry.
mvn -B clean package # or mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
Sie finden die URL und die Benutzerberechtigungsnachweise, die Sie für die Verbindungsherstellung mit Ihrer Registry verwendet haben, in den Konfigurationseinstellungen für die Artifactory-Toolintegration.
-
Klicken Sie auf SPEICHERN. Wann immer Ihre Pipeline ausgeführt wird, verwendet dieser Buildjob die Konfigurationsinformationen aus der Artifactory-Toolintegration, um eine Verbindung zu Ihrem Maven-Repository herzustellen.
Konfigurieren von Artifactory mit Hilfe der API
Die Integration des Tools Artifactory unterstützt die folgenden Konfigurationsparameter, die Sie mit der Toolchain-HTTP-API und den SDKs verwenden, wenn Sie Toolintegrationen erstellen, lesenund aktualisieren.
Sie müssen die Eigenschaft tool_type_id
im Anforderungshauptteil mit dem Wert artifactory
angeben.
Parameter | Verwendung | Typ | Terraform-Argument | Beschreibung |
---|---|---|---|---|
dashboard_url | Optional, aktualisierbar | Zeichenfolge | dashboard_url | Die URL des Artifactory-Server-Dashboards für diese Toolintegration. In der grafischen Benutzerschnittstelle ruft der Browser dieses Dashboard auf, sobald Sie auf die Toolintegrationskarte Artifactory klicken. |
spiegel_url | Optional, aktualisierbar | Zeichenfolge | spiegel_url | Die URL Ihres virtuellen Repositorys Artifactory, in dem Sie Ihre privaten Repositorys und einen Cache der öffentlichen Repositorys anzeigen können |
Name | erforderlich, aktualisierbar | Zeichenfolge | Name | Der Name dieser Toolintegration. |
Release-URL | Optional, aktualisierbar | Zeichenfolge | Release-URL | Die URL Ihres Release-Repositorys Artifactory. |
Repositoryname | Optional, aktualisierbar | Zeichenfolge | Repositoryname | Der Name Ihres Repositorys Artifactory, in dem sich Ihre Docker-Images befinden. |
Repository-URL | Optional, aktualisierbar | Zeichenfolge | Repository-URL | Die URL Ihres Repositorys Artifactory, in dem sich Ihre Docker-Images befinden. |
Momentaufnahme-URL | Optional, aktualisierbar | Zeichenfolge | Momentaufnahme-URL | Die URL Ihres Artifactory-Momentaufnahmenrepositorys |
Token | Optional, aktualisierbar | Kennwort | Token | Das Zugriffstoken für Ihr Artifactory-Repository. Für diesen Parameter können Sie eine Referenz auf einen geheimen Toolchain-Schlüssel verwenden. Weitere Informationen zu Referenzen auf geheime Toolchain-Schlüssel: Schützen Sie Ihre sensiblen Daten in Continuous Delivery. |
Typ | erforderlich, aktualisierbar | Zeichenfolge | Typ | Der Repositorytyp für Ihre Artifactory-Toolintegration. |
Benutzer-ID | Optional, aktualisierbar | Zeichenfolge | Benutzer-ID | Die Benutzer-ID oder E-Mail-Adresse für Ihr Artifactory-Repository. |