Projekt- und Entwicklungsumgebung einrichten

Zum Einstieg in Vertex AI erfahren Sie auf dieser Seite, wie Sie ein Google Cloud-Projekt erstellen und die Vertex AI APIs aktivieren. Wenn Sie nicht die Berechtigungen zum Ausführen dieser Aufgaben haben, bitten Sie einen Administrator, ein Projekt einzurichten und Vertex AI für Sie zu aktivieren. Außerdem wird beschrieben, wie Sie die Google Cloud CLI in Ihrer lokalen Entwicklungsumgebung einrichten.

Projekt einrichten

So richten Sie ein Projekt ein:

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Authentifizierung einrichten

    Select the tabs for how you plan to access the API:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. Update and install gcloud components:

    gcloud components update
    gcloud components install beta

    4. Führen Sie den folgenden Befehl aus, um die gcloud CLI so einzurichten, dass die Authentifizierung bei Google APIs anstelle Ihrer Nutzeranmeldedaten erfolgt: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Weitere Informationen finden Sie unter Identitätswechsel für Dienstkonten.

    Clientbibliotheken

    Zur Verwendung von Clientbibliotheken in einer lokalen Entwicklungsumgebung installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten in der Dokumentation zur Google Cloud-Authentifizierung.

    Führen Sie den folgenden Befehl aus, um Ihre lokale ADC-Datei so einzurichten, dass sie sich bei Google APIs anstelle Ihrer Nutzeranmeldedaten authentifiziert: 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    Weitere Informationen finden Sie unter Identitätswechsel für Dienstkonten.

    REST

    Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API in einer lokalen Entwicklungsumgebung zu verwenden.

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

    Sie können die Identitätsübertragung für ein Dienstkonto verwenden, um ein Zugriffstoken für REST API-Anfragen zu generieren. Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.

    Informationen zum Einrichten der Authentifizierung für eine Produktionsumgebung finden Sie in der Dokumentation zur Google Cloud-Authentifizierung unter Set up Application Default Credentials for code running on Google Cloud.

Bitten Sie einen Administrator, ein Vertex AI-Projekt für Sie einzurichten.

In diesem Abschnitt wird beschrieben, wie ein Administrator die Rollen gewährt, die für die Nutzung von Vertex AI erforderlich sind.

  1. Legen Sie einen aussagekräftigen Projektnamen und eine Projekt-ID fest, um Ihr Projekt zu identifizieren. Wenn Sie Teil einer Organisation sind oder mehrere Projekte erstellen möchten, sollten Sie sich überlegen, welche Namenskonventionen und Ordnerhierarchien befolgt werden oder befolgt werden könnten, um die Projektorganisation klar zu gestalten.
  2. Erforderliche Rollen:
    1. Der Zugriff auf die meisten Vertex AI-Funktionen wird durch die IAM-Rolle (roles/aiplatform.user) Vertex AI-Nutzer gewährt und sollte für die meisten Vertex AI-Nutzer ausreichend sein. Wenn Sie uneingeschränkten Zugriff auf Vertex AI-Ressourcen benötigen, können Sie die Rolle Vertex AI Administrator (roles/aiplatform.admin) anfordern. Informationen zu den Unterschieden zwischen diesen und anderen Vertex AI-Rollen finden Sie unter Vertex AI-Zugriffssteuerung mit IAM.
    2. Wenn Sie auch Vertex AI Workbench-Instanzen in Google Cloud verwenden möchten, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Notebooks Administrator (roles/notebooks.admin) für das Projekt sowie die IAM-Rolle Service Account User (roles/iam.serviceAccountUser) entweder für das Projekt oder für das Compute Engine-Standarddienstkonto zu gewähren.
    3. Zum Aktivieren der erforderlichen APIs benötigen Sie außerdem die Service Usage-Administrator (roles/serviceusage.serviceUsageAdmin) IAM-Rolle oder Ihr Administrator muss die APIs über die folgenden ersten Schritte für Sie aktivieren.
  3. Bitten Sie Ihren Administrator, Vertex AI APIs für Sie zu aktivieren. Wenn Ihnen die (roles/serviceusage.serviceUsageAdmin)-IAM-Rolle Service Usage-Administrator zugewiesen ist, können Sie dies selbst tun.

Nächste Schritte