Configurar un proyecto y un entorno de desarrollo

Para que empieces a usar Vertex AI, en esta página se explica cómo crear un Google Cloud proyecto y habilitar las APIs de Vertex AI. Si no tienes los permisos necesarios para realizar estas tareas, pide a un administrador que configure un proyecto y habilite Vertex AI por ti. En esta página también se explica cómo configurar la CLI de Google Cloud en tu entorno de desarrollo local.

Configurar un proyecto

Sigue estos pasos para configurar un proyecto:

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.

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

Verify that billing is enabled for your Google Cloud project.

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

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

Verify that billing is enabled for your Google Cloud project.

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

Configurar la autenticación

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. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

3. Para inicializar gcloud CLI, ejecuta el siguiente comando:

   gcloud init

4. Después de inicializar gcloud CLI, actualízala e instala los componentes necesarios:

   gcloud components update
   gcloud components install beta

Para configurar gcloud CLI de forma que use la suplantación de identidad de la cuenta de servicio para autenticarse en las APIs de Google en lugar de usar tus credenciales de usuario, ejecuta el siguiente comando:

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Para obtener más información, consulta el artículo Suplantación de identidad de cuentas de servicio.

Bibliotecas de cliente

Para usar bibliotecas de cliente en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

1. Install the Google Cloud CLI.

2. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

3. Después de inicializar gcloud CLI, actualízala e instala los componentes necesarios:

   gcloud components update
   gcloud components install beta

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.

Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

Para configurar tu archivo ADC local de forma que use la suplantación de identidad de la cuenta de servicio para autenticarte en las APIs de Google en lugar de usar tus credenciales de usuario, ejecuta el siguiente comando:

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

Para obtener más información, consulta el artículo Suplantación de identidad de cuentas de servicio.

REST

Para usar la API REST en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

1. Install the Google Cloud CLI.

2. Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

3. Después de inicializar gcloud CLI, actualízala e instala los componentes necesarios:

   gcloud components update
   gcloud components install beta

Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Puedes usar la suplantación de identidad de una cuenta de servicio para generar un token de acceso para las solicitudes de la API REST. Para obtener más información, consulta el artículo Cuenta de servicio suplantada.

Para obtener información sobre cómo configurar la autenticación en un entorno de producción, consulta Set up Application Default Credentials for code running on Google Cloud en la documentación sobre autenticación. Google Cloud

Pedir a un administrador que configure un proyecto de Vertex AI

En esta sección se describe cómo puede un administrador conceder los roles necesarios para usar Vertex AI.

1. Elige un nombre y un ID de proyecto significativos para identificar tu proyecto. Si formas parte de una organización o tienes previsto crear varios proyectos, piensa en las convenciones de nomenclatura y las jerarquías de carpetas que se siguen o se podrían seguir para que la organización de los proyectos sea clara.
2. Roles necesarios:
   1. El acceso a la mayoría de las funciones de Vertex AI se concede mediante el rol de gestión de identidades y accesos Usuario de Vertex AI (roles/aiplatform.user) y debería ser suficiente para la mayoría de los usuarios de Vertex AI. Para tener control total sobre los recursos de Vertex AI, puedes solicitar el rol Administrador de Vertex AI (roles/aiplatform.admin). Para conocer las diferencias entre estos y otros roles de Vertex AI, consulta el artículo sobre el control de acceso a Vertex AI con IAM.
   2. Si también tienes previsto usar instancias de Vertex AI Workbench en Google Cloud, pide a tu administrador que te conceda el rol de administrador de cuadernos (roles/notebooks.admin) de gestión de identidades y accesos del proyecto, así como el rol de usuario de cuenta de servicio (roles/iam.serviceAccountUser) de gestión de identidades y accesos del proyecto o de la cuenta de servicio predeterminada de Compute Engine.
   3. Además, para habilitar las APIs necesarias, debes tener el rol de gestión de identidades y accesos Administrador de uso de servicios (roles/serviceusage.serviceUsageAdmin) o tu administrador debe habilitar las APIs por ti siguiendo los primeros pasos.
3. Pide a tu administrador que habilite las APIs de Vertex AI. Si tienes el rol de gestión de identidades y accesos Administrador de uso de servicios (roles/serviceusage.serviceUsageAdmin), podrás hacerlo por tu cuenta.

Siguientes pasos

• Consulta una descripción general de Vertex AI.

• Consulta uno de los tutoriales para usar Vertex AI.

• Consulta cómo usar el SDK de Vertex AI para Python, que ofrece otra forma de interactuar con Vertex AI.

Enviar comentarios