Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Developer Connect-Statistiken einrichten

In diesem Dokument wird beschrieben, wie Sie Developer Connect-Statistiken einrichten, damit sie für Gemini Cloud Assist-Untersuchungen und in Cloud Logging verfügbar sind.

Weitere Informationen zu Developer Connect-Statistiken

Hinweis

Melden Sie sich bei Ihrem Google-Konto an.

Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

Enable the API

Wenn Sie Developer Connect aktivieren, wird auch die Secret Manager API aktiviert.

Installieren Sie die Google Cloud CLI.
Wenn Sie das Cloud SDK bereits installiert haben, prüfen Sie, ob Sie die neueste verfügbare Version haben. Führen Sie dazu den Befehl gcloud components update aus.
Erstellen Sie den Developer Connect Dienst-Agent:
```
gcloud beta services identity create \
--service=developerconnect.googleapis.com \
--project=PROJECT_NUM
```
Die Rolle roles/developerconnect.serviceAgent wird diesem Dienst-Agent automatisch hinzugefügt.

Erforderliche Rollen

Wenn Ihre Insights-Konfiguration auf eine App Hub-Anwendung beschränkt ist, die von einem Verwaltungsprojekt (Ordnergrenze) verwaltet wird:

Der Nutzer, der Statistiken konfiguriert, benötigt die folgenden Rollen für das Verwaltungsprojekt:
- Developer Connect Insights Admin (roles/developerconnect.insightsAdmin)
- Viewer von App Hub (roles/apphub.viewer)
Der Developer Connect Service Agent benötigt die folgenden Rollen:
- Die Rolle „Developer Connect Service Agent“ (roles/developerconnect.serviceAgent) und die Rolle „Developer Connect Insights Agent“ (roles/developerconnect.insightsAgent) im Verwaltungsprojekt.
- Die Rolle „Developer Connect Insights Agent“ (roles/developerconnect.insightsAgent) aus dem Ordner, der das Verwaltungsprojekt enthält.

Wenn Ihre Konfiguration für Statistiken auf eine App Hub-Anwendung beschränkt ist, die von einem Hostprojekt verwaltet wird:

Der Nutzer, der Insights konfiguriert, benötigt die folgenden Rollen für das Hostprojekt:
- Developer Connect Insights Admin (roles/developerconnect.insightsAdmin)
- Viewer von App Hub (roles/apphub.viewer)
Der Developer Connect Service Agent benötigt die folgenden Rollen:
- Die Rolle „Developer Connect Service Agent“ (roles/developerconnect.serviceAgent) und die Rolle „Developer Connect Insights Agent“ (roles/developerconnect.insightsAgent) für das Hostprojekt.
- Die Rolle „Developer Connect Insights Agent“ (roles/developerconnect.insightsAgent) für alle Dienstprojekte.
- Wenn Sie vorhandene Ressourcen (z. B. aus Cloud Build oder Artifact Registry) verwenden, die sich nicht im selben Ordner befinden, weisen Sie dem Developer Connect-Dienst-Agent aus dem Hostprojekt in diesen Projekten die Rolle „Developer Connect Insights Agent“ zu.

Wenn Ihre Konfiguration für Statistiken auf einzelne Zielprojekte beschränkt ist:

Der Nutzer, der Insights konfiguriert, benötigt die folgenden Rollen für das Hostprojekt:
- „Developer Connect Insights Admin“ (roles/developerconnect.insightsAdmin)
Der Developer Connect Service Agent benötigt die folgenden Rollen:
- Die Rolle „Developer Connect Service Agent“ (roles/developerconnect.serviceAgent) und die Rolle „Developer Connect Insights Agent“ (roles/developerconnect.insightsAgent) für das Hostprojekt.
- Die Rolle „Developer Connect Insights Agent“ (roles/developerconnect.insightsAgent) für alle Zielprojekte.

Um Statistiken über die Befehlszeile aufzurufen, benötigen Nutzer, die Statistiken aufrufen Folgendes:

Developer Connect Insights Viewer (roles/developerconnect.insightsViewer) für das Hostprojekt.
Rolle „Betrachter von Container Analysis-Vorkommen“ (roles/containeranalysis.occurrences.viewer) für das Hostprojekt.

Für die Verwendung einzelner Tools oder für bestimmte Anwendungsfälle sind möglicherweise zusätzliche Google Cloud oder Nicht-Google-Rollen und ‑Berechtigungen erforderlich. Wenn Berechtigungsfehler auftreten, wenden Sie sich an Ihren Administrator, um zu prüfen, ob Sie die richtigen Rollen und Berechtigungen haben.

Neben diesen Rollen und Berechtigungen müssen Sie beim Konfigurieren einer neuen Insights-Konfiguration über den interaktiven Workflow Zugriff auf alle angegebenen Ressourcen haben.

Zusätzliche Voraussetzungen

Wenn Sie möchten, dass Ihre Developer Connect-Statistiken auf eine App Hub-Anwendung beschränkt werden, müssen Sie diese Anwendung haben oder erstellen.

Developer Connect-Statistiken unterstützen alle Einrichtungsmodelle für Anwendungen im App Hub. Wir empfehlen, einen für die Anwendungsverwaltung konfigurierten Ordner zu verwenden, damit Sie Gemini Cloud Assist und andere anwendungsbezogene Funktionen nutzen können.

Sie können Ihre Developer Connect-Statistiken auch auf ein Projekt statt auf eine App Hub-Anwendung beschränken.
Sie müssen Cloud Build und ein unterstütztes Quellcode-Verwaltungssystem (GitHub, GitLab oder Bitbucket) verwenden.
Ihr Build muss Herkunftsinformationen generieren, damit diese in den Logs enthalten sind.

Die Daten können aus einer der folgenden Quellen stammen:
- Cloud Build und Artifact Registry verwenden
  
  Sie können Cloud Build verwenden, um Ihr Image zu erstellen. Der Build muss mit einem Trigger gestartet werden und der Build-Prozess muss die Herkunft generieren. Von Ihrem Build generierte Artefakte werden in Artifact Registry gespeichert.
- GitHub-Attestierungen verwenden
  
  Wenn Sie Version 4 oder höher von docker/build-push-action verwenden, werden dem Bild automatisch Herkunftsnachweise hinzugefügt.
  
  Alternativ können Sie actions/attest-build-provenance mit der Option push-to-registry verwenden, um die Herkunftserklärung in der Container Registry zu veröffentlichen. Dort können Developer Connect-Statistiken sie unabhängig vom Registry-Anbieter lesen.
- Verwenden Sie das Flag docker buildx provenance.
  
  Weitere Informationen
- Verwenden Sie den docker buildx-Registrierungsexporter.
  
  Setzen Sie oci-artifact auf true. Weitere Informationen
GitHub-Atteste müssen aus einem öffentlich verfügbaren Repository stammen. Das docker buildx-Artefakt muss öffentlich in der Containerregistrierung verfügbar sein.

Sie können Developer Connect-Statistiken weiterhin ohne Herkunft verwenden, aber die Statistiken sind weniger nützlich.
Gemini Cloud Assist

Developer Connect-Statistiken verbessern die Gemini Cloud Assist-Funktionen, indem dem Untersuchungskontext Ereignisse zur Anwendungsbereitstellung hinzugefügt werden. Sie können Gemini Cloud Assist aktivieren, um Developer Connect-Informationen mit Gemini Cloud Assist-Prüfungen zu verwenden.
Wenn Ihre Developer Connect-Statistiken auf eine App Hub-Anwendung beschränkt werden, muss sich Ihre Konfiguration für Statistiken im selben Projekt wie diese Anwendung befinden.

Wenn der Bereich auf das Projekt beschränkt ist, muss sich die Konfiguration nicht im selben Projekt wie das Projekt im Bereich befinden.

Es wird empfohlen, Ihre anderen anwendbaren Ressourcen (z. B. Developer Connect-Statistiken, Google Kubernetes Engine-Cluster, Cloud Run-Dienste, Cloud Build, Artifact Registry-Repositories) am selben Standort zu haben, dies ist jedoch nicht erforderlich.

Anwendung in App Hub erstellen

Das ist nur relevant, wenn Sie Ihre Developer Connect-Statistiken auf eine App Hub-Anwendung eingrenzen.

App Hub einrichten Wir empfehlen, einen für die Anwendungsverwaltung konfigurierten Ordner zu verwenden, damit Sie Gemini Cloud Assist und andere anwendungsbezogene Funktionen nutzen können.
Erstellen Sie eine App Hub-Anwendung.
- Informationen zum Erstellen einer Anwendung aus vorhandenen Google Cloud Ressourcen finden Sie unter Ressourcen für eine Anwendung registrieren.
- Wenn Sie eine neue Anwendung entwerfen und bereitstellen möchten, können Sie das Application Design Center verwenden.

Developer Connect-Statistiken für Ihre Anwendung konfigurieren

Erstellen Sie mit dem folgenden Befehl einen Developer Connect-Insight:

gcloud developer-connect insights-configs create DCI_CONFIG_NAME \
       --project PROJECT_ID \
       --app-hub-application APP_HUB_APPLICATION_NAME \
       --target-projects TARGET_PROJECT_IDS \
       --location LOCATION

Wobei:

DCI_CONFIG_NAME ist ein Name für die zu generierende Konfiguration für Statistiken.
PROJECT_ID ist die ID des Projekts, in dem Sie die Konfiguration für Developer Connect-Statistiken erstellen.
APP_HUB_APPLICATION_NAME ist der vollständig qualifizierte Name der App Hub-Anwendung, die Sie zuvor erstellt haben.

Dies gilt nur, wenn Sie diese Konfiguration für Statistiken auf eine App Hub-Anwendung und nicht auf ein Projekt beschränken.
TARGET_PROJECT_IDS ist die durch Kommas getrennte Liste der IDs der Projekte, auf die Sie diese Konfiguration für Developer Connect-Statistiken beschränken.

Dies ist nur relevant, wenn Sie diese Konfiguration für Statistiken auf ein Projekt und nicht auf eine App Hub-Anwendung beschränken.
LOCATION ist die Region, in der Sie diese Konfiguration für Statistiken erstellen möchten.

Mit diesem Befehl wird ein automatischer Erkennungsprozess ausgelöst, der alle App Hub-Arbeitslasten und -Dienste in Ihrem Projekt findet. Bei diesem Vorgang wird auch geprüft, ob Sie die erforderlichen Berechtigungen haben.

Dieser Befehl gibt auch eine OPERATION_ID zurück, mit der Sie den Status der Konfiguration prüfen können.

So prüfen Sie den Status Ihrer Developer Connect-Statistikkonfiguration:

gcloud developer-connect operations describe OPERATION_ID

Dabei ist OPERATION_ID die vollständig angegebene Vorgangs-ID, die vom Befehl gcloud developer-connect insights-configs create zurückgegeben wurde.

Dieser Vorgang ist ein Empfang der ursprünglichen Anfrage. Das Feld response darin ist ein Snapshot der Ressource genau in dem Moment, in dem die Erstellungsaufgabe akzeptiert wurde. Führen Sie den Befehl insights-configs describe aus, um den Status des Erkennungsprozesses abzurufen.

Nach Abschluss der automatischen Erkennung können Sie den Status dieser Developer Connect-Statistiken mit dem folgenden Befehl prüfen:

gcloud developer-connect insights-configs describe DCI_CONFIG_NAME \
       --location=REGION