Guía de inicio rápido: Crea una instancia de Cloud Run

Guía de inicio rápido: Crea una instancia de Cloud Run

Versión preliminar : Instancias de Cloud Run

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles "tal como están" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se muestra cómo usar Cloud Run para crear una instancia de Cloud Run en un contenedor de muestra, ver sus registros y administrar su ciclo de vida con gcloud CLI.

Antes de comenzar

1. Instala Google Cloud CLI.

   Nota: Si ya instalaste gcloud CLI, asegúrate de tener la versión más reciente ejecutando gcloud components update.

2. Configura gcloud CLI para usar tu identidad federada.

   Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.

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

   gcloud init

4. Crea o selecciona un Google Cloud proyecto.

   Roles necesarios para seleccionar o crear un proyecto

   • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
   • Crea un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.
   Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   • Crea un Google Cloud proyecto de:

     gcloud projects create PROJECT_ID

     Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto de que estás creando.

   • Selecciona el Google Cloud proyecto de que creaste:

     gcloud config set project PROJECT_ID

     Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto de.

5. Si usas un proyecto existente en esta guía, verifica que tengas los permisos necesarios para completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

6. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

7. Habilita la API de Cloud Run Admin y las APIs de Cloud Logging:

   Roles necesarios para habilitar las APIs

   Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

   gcloud services enable run.googleapis.com logging.googleapis.com

8. Para configurar el proyecto predeterminado para tu instancia de Cloud Run, haz lo siguiente:

   gcloud config set project PROJECT_ID

   Reemplaza PROJECT_ID por el nombre del proyecto que creaste para esta guía de inicio rápido.
9. Asegúrate de tener instalado el componente gcloud beta:

   gcloud components install beta

10. Revisa los precios de Cloud Run o estima los costos con la calculadora de precios.

Roles obligatorios

Si quieres obtener los permisos que necesitas para completar esta guía de inicio rápido, pídele a tu administrador que te otorgue los siguientes roles de IAM:

• Administrador de Cloud Run (roles/run.admin) en la instancia
• Usuario de la cuenta de servicio (roles/iam.serviceAccountUser) en la identidad del servicio
• Visualizador de registros (roles/logging.viewer) en el proyecto

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Crea una instancia

Para crear una instancia de Cloud Run en un contenedor de muestra con gcloud CLI, haz lo siguiente:

1. Ejecuta el siguiente comando:

   gcloud beta run instances create my-instance \
   --image us-docker.pkg.dev/cloudrun/container/hello \
   --region REGION \
   --port 8080 \
   --no-invoker-iam-check

   Reemplaza REGION por una región admitida Google Cloud .

   La marca --no-invoker-iam-check inhabilita la autenticación del invocador de IAM, lo que hace que la URL de la instancia sea accesible sin autenticación de IAM.

2. Espera a que termine de crearse la instancia. Cuando se complete, el comando mostrará un resultado similar al siguiente:

   Creating instance...
   Importing container..............done
   Provisioning resources.......done
   Starting instance.....done
   Done.
   Instance [my-instance] has successfully been created.
   
   URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
   

3. Abre la URL que se muestra en tu navegador para interactuar con el contenedor en ejecución.

Ver registros de instancias

Para ver los registros generados por tu instancia de Cloud Run, haz lo siguiente:

1. En la Google Cloud consola de, ve al Explorador de registros:

   Ir al Explorador de registros

2. Filtra los registros de tu instancia específica:

   resource.type="cloud_run_instance"
   resource.labels.location="<var>REGION</var>"
   resource.labels.instance_name="my-instance"
   

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu Google Cloud cuenta por los recursos que usaste en esta página.

Borra tu instancia

Para detener y borrar la instancia de Cloud Run, haz lo siguiente:

gcloud beta run instances delete my-instance --region REGION

Borra el proyecto de prueba

Si borras tu Google Cloud proyecto de, se dejan de facturar todos los recursos que usaste en ese proyecto. Para liberar todos los Google Cloud recursos de tu proyecto, sigue estos pasos:

Precaución: Borrar un proyecto tiene estas consecuencias:
• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una appspot.com URL, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Borra un Google Cloud proyecto de:

gcloud projects delete PROJECT_ID

¿Qué sigue?

Para obtener más información sobre las instancias de Cloud Run, consulta lo siguiente:

• Crea y administra instancias de Cloud Run
• Ciclo de vida de la instancia de Cloud Run