In der kostenlosen Stufe werden Assured Open Source Software-Pakete (Assured OSS) in einem von Google verwalteten Artifact Registry-Repository gehostet. Wenn Sie direkt auf die Java-Pakete zugreifen und sie herunterladen möchten, können Sie eine Verbindung zum Artifact Registry-Repository für Assured OSS herstellen.
Dieses Dokument gilt nur für die kostenlose Stufe. Informationen zur Premium-Stufe finden Sie unter Java-Pakete über direkten Repository-Zugriff herunterladen.
Hinweis
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Zentraler Dienstkontoadministrator (
roles/iam.serviceAccountKeyAdmin) für Ihre Organisation zuzuweisen. Sie benötigen diese Berechtigung, um den base64-codierten String des Dienstkontoschlüssels abzurufen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.Assured OSS konfigurieren Senden Sie für die kostenlose Stufe das Formular zur Kundenaktivierung, um den Zugriff auf Assured OSS zu aktivieren.
Prüfen Sie die Verbindung zu Assured OSS für die angeforderten Dienstkonten.
Aktivieren Sie die Artifact Registry API für das übergeordnete Projekt in Google Cloud der Dienstkonten, die für den Zugriff auf Assured OSS verwendet werden.
Installieren Sie die aktuelle Version der Google Cloud CLI. Wenn Sie die Google Cloud CLI bereits installiert haben, prüfen Sie, ob Sie die aktuelle Version haben. Führen Sie dazu diesen Befehl aus:
gcloud components update
Authentifizierung einrichten
Artifact Registry unterstützt die folgenden Authentifizierungsmethoden:
- Authentifizierung mit einem Hilfsprogramm für Anmeldedaten
- Authentifizierung mit einem Passwort
In den folgenden Abschnitten wird beschrieben, wie Sie diese Authentifizierungsmethoden einrichten.
Mit einem Hilfsprogramm für Anmeldedaten authentifizieren
Artifact Registry bietet einen Maven-Wagon und ein Gradle-Plug-in, die als Anmeldedaten-Hilfsprogramme verwendet werden können. Diese Option bietet die größte Flexibilität.
Informationen zum Einrichten von Standardanmeldedaten für Anwendungen finden Sie unter Authentifizierung einrichten.
Anmeldedaten-Hilfsprogramme einrichten
Nehmen Sie die folgenden Änderungen basierend auf dem Build-Tool vor, um die Authentifizierung mit einem Hilfsprogramm für Anmeldedaten einzurichten:
Maven
<project>
<build>
<extensions>
<extension>
<groupId>com.google.cloud.artifactregistry</groupId>
<artifactId>artifactregistry-maven-wagon</artifactId>
<version>2.2.0</version>
</extension>
</extensions>
</build>
</project>
Gradle
plugins {
id "com.google.cloud.artifactregistry.gradle-plugin" version "2.2.0"
}
Mit einem Passwort authentifizieren
Authentifizierung mit einem Passwort, wenn Ihre Java-Anwendung eine Authentifizierung mit einem bestimmten Nutzernamen und Passwort erfordert. Ändern Sie die Einstellungen je nach Build-Tool:
Maven
Fügen Sie im Abschnitt settings der Datei ~/.m2/settings.xml die folgenden Authentifizierungseinstellungen hinzu. Wenn die Datei noch nicht vorhanden ist, erstellen Sie sie. Weitere Informationen finden Sie in der Referenz zu den Maven-Einstellungen.
<settings>
<servers>
<server>
<id>artifact-registry</id>
<configuration>
<httpConfiguration>
<get>
<usePreemptive>true</usePreemptive>
</get>
<head>
<usePreemptive>true</usePreemptive>
</head>
<put>
<params>
<property>
<name>http.protocol.expect-continue</name>
<value>false</value>
</property>
</params>
</put>
</httpConfiguration>
</configuration>
<username>_json_key_base64</username>
<password>KEY</password>
</server>
</servers>
</settings>
Ersetzen Sie KEY durch die Base64-Codierung der gesamten JSON-Schlüsseldatei des Dienstkontos. Führen Sie hierzu den folgenden Befehl aus:
cat KEY_FILE_LOCATION | base64
Dabei ist KEY_FILE_LOCATION der Speicherort der JSON-Schlüsseldatei des Dienstkontos.
Gradle
Fügen Sie der Datei ~/.gradle/gradle.properties die folgende Zeile hinzu, damit der Schlüssel in Ihren Builds oder Ihrem Quellcode-Repository nicht sichtbar ist.
artifactRegistryMavenSecret = KEY
Ersetzen Sie KEY durch den privaten Schlüssel aus der JSON-Schlüsseldatei Ihres Dienstkontos. Bei json_key_base64 enthält artifactRegistryMavenSecret das base64-verschlüsselte Passwort. Beispiel: base64 -w 0 KEY
Geben Sie in der Datei build.gradle die Repository-Einstellungen wie im folgenden Beispiel an:
repositories {
maven {
url "artifactregistry://us-maven.pkg.dev/cloud-aoss/cloud-aoss-java"
credentials {
username = "_json_key_base64"
password = "$artifactRegistryMavenSecret"
}
authentication {
basic(BasicAuthentication)
}
}
}
Projektkonfigurationsdatei aktualisieren, sodass sie auf das Repository verweist
Maven
Fügen Sie die folgenden Einstellungen dem entsprechenden Abschnitt in der Datei pom.xml für Ihr Maven-Projekt hinzu. Ersetzen Sie die Authentifizierungseinstellungen nicht.
<project>
<repositories>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-maven.pkg.dev/cloud-aoss/cloud-aoss-java</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
</project>
Weitere Informationen zur Struktur der Datei finden Sie in der POM-Referenz von Maven.
Gradle
Geben Sie in der Datei build.gradle die folgenden Repository-Einstellungen an. Ersetzen Sie die Authentifizierungseinstellungen nicht.
repositories {
maven {
url "artifactregistry://us-maven.pkg.dev/cloud-aoss/cloud-aoss-java"
}
}
Projektkonfigurationsdatei aktualisieren, um Abhängigkeiten hinzuzufügen
Wenn Sie ein Artefakt als Teil Ihres Builds herunterladen möchten, muss es als Abhängigkeit deklariert werden.
Maven
Deklarieren Sie die Pakete, die Sie herunterladen möchten, in der Datei pom.xml für Ihr Maven-Projekt.
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.17.1</version>
</dependency>
Gradle
Deklarieren Sie die Pakete, die Sie herunterladen möchten, in der Datei build.gradle.
dependencies {
compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.17.1'
}
Auf Java-Pakete zugreifen, die in Assured OSS nicht verfügbar sind
Sie können auf Pakete zugreifen, die im Artifact Registry-Repository für Assured OSS nicht verfügbar sind.
Assured OSS ist mit Assured OSS als bevorzugtem Repository sowie kanonischen öffentlichen Repositories, wie Maven Central oder PyPI, als sekundären Repositories vorkonfiguriert. Wenn Sie die Funktion (Vorabversion) verwenden möchten, rufen Sie die folgende URL auf:
https://us-maven.pkg.dev/cloud-aoss/java
Alle in Assured OSS verfügbaren Java-Pakete auflisten
Wenn Sie eine API verwenden möchten, um eine Liste aller im Artifact Registry-Repository verfügbaren Java-Pakete abzurufen, lesen Sie den Hilfeartikel Alle in Assured OSS verfügbaren Java-Pakete auflisten.