Configurazione di un progetto e di un ambiente di sviluppo

Per iniziare a utilizzare Vertex AI, questa pagina ti guida nella creazione di un progetto e nell'attivazione delle API Vertex AI. Google Cloud Se non disponi delle autorizzazioni per eseguire queste attività, chiedi a un amministratore di configurare un progetto e abilitare Vertex AI per te. Questa pagina illustra anche come configurare Google Cloud CLI nel tuo ambiente di sviluppo locale.

Configura un progetto

Per configurare un progetto:

  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.

    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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

    Configura l'autenticazione

      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. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

      3. Per inizializzare gcloud CLI, esegui questo comando: 

        gcloud init

      4. Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti: 

        gcloud components update
gcloud components install beta

        5. Per configurare gcloud CLI in modo che utilizzi la simulazione dell'identità dei service account per l'autenticazione alle API di Google, anziché le tue credenziali utente, esegui questo comando: 

        gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

        Per ulteriori informazioni, vedi Simulazione dell'identità dei service account.

        Librerie client

        Per utilizzare le librerie client in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione e con le tue credenziali utente.

        1. Install the Google Cloud CLI.

        2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

        3. Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti: 

          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.

          If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

        Per saperne di più, consulta Configurare ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .

        Per configurare il file ADC locale in modo che utilizzi la simulazione dell'identità dei service account per l'autenticazione alle API di Google, anziché le credenziali utente, esegui il seguente comando: 

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

        Per ulteriori informazioni, vedi Simulazione dell'identità dei service account.

        REST

        Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizzi le credenziali fornite a gcloud CLI.

        1. Install the Google Cloud CLI.

        2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

        3. Dopo aver inizializzato gcloud CLI, aggiornala e installa i componenti richiesti: 

          gcloud components update
gcloud components install beta

        Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

        Puoi utilizzare l'imitazione dell'account di servizio per generare un token di accesso per le richieste API REST. Per saperne di più, vedi Service account con rappresentazione.

        Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Set up Application Default Credentials for code running on Google Cloud nella documentazione sull'autenticazione Google Cloud .

        Chiedi a un amministratore di configurare un progetto Vertex AI per te

        Questa sezione descrive come un amministratore concede i ruoli necessari per utilizzare Vertex AI.

        1. Determina un nome e un ID progetto significativi per identificare il tuo progetto. Se fai parte di un'organizzazione o prevedi di creare più progetti, valuta quali convenzioni di denominazione e gerarchie di cartelle vengono seguite o potrebbero essere seguite per rendere chiara l'organizzazione dei progetti.
        2. Ruoli richiesti:
          1. L'accesso alla maggior parte delle funzionalità di Vertex AI viene concesso dal ruolo IAM Vertex AI User (roles/aiplatform.user) e dovrebbe essere sufficiente per la maggior parte degli utenti di Vertex AI. Per il controllo completo delle risorse Vertex AI, puoi richiedere il ruolo Amministratore Vertex AI (roles/aiplatform.admin). Per esplorare le differenze tra questi e altri ruoli Vertex AI, consulta Controllo dell&#3controllo dell'accessoso di Vertex AI con IAM.
          2. Se intendi utilizzare anche le istanze Vertex AI Workbench in Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Amministratore notebook (roles/notebooks.admin) per il progetto, nonché il ruolo IAM Utente service account (roles/iam.serviceAccountUser) per il progetto o per il service account predefinito di Compute Engine.
          3. Inoltre, per abilitare le API necessarie, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin) oppure l'amministratore deve abilitare le API per te seguendo i primi passaggi.
        3. Chiedi all'amministratore di abilitare le API Vertex AI per te. Se ti viene concesso il ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), potrai farlo autonomamente.

        Passaggi successivi