Administra servicios

En esta página, se describe cómo crear un servicio y ver su información. Los servicios son los recursos principales de Cloud Run for Anthos en Google Cloud.

Crea un servicio

Para crear un servicio nuevo, debes implementar una imagen de contenedor en él por primera vez. Para implementar un servicio nuevo, se requieren más instrucciones.

Visualiza la lista de servicios en el proyecto

Puedes ver una lista de los servicios disponibles en el proyecto mediante Cloud Console o la línea de comandos de gcloud:

Console

Para ver la lista de servicios, debes hacer lo siguiente:

  1. Implementar en Cloud Run for Anthos en Google Cloud

  2. Examinar la lista de servicios que se muestra para el proyecto:

    lista de servicios

Línea de comandos

Para enumerar los servicios del proyecto, ejecuta este comando:

gcloud kuberun core services list

Puedes filtrar esta lista por propiedades de la definición del servicio, como una etiqueta asignada.

Cloud Code

A fin de ver la lista de servicios con Cloud Code, lee las guías de Cloud Run Explorer para IntelliJ y Visual Studio Code.

Copia un servicio

Se puede hacer una copia de un servicio existente mediante Cloud Console o YAML. También se puede cambiar lo que quieras en la copia, incluidos el nombre y la región.

Console

Para copiar un servicio:

  1. Implementar en Cloud Run for Anthos en Google Cloud

  2. Selecciona el servicio que deseas copiar de la lista de servicios que se muestra para tu proyecto:

    lista de servicios

    1. Haz clic en Copy (Copiar).

    2. En la página de copia del servicio, configura o cambia cualquier valor que desees cambiar, como región, etc. Si mantienes la misma región, debes proporcionar un nombre nuevo para el servicio.

    3. Haz clic en Create (Crear) para crear una copia y, luego, implementarla mediante el nombre del servicio nuevo.

YAML

Si deseas usar un archivo YAML para modificar la configuración de tu servicio existente, obtén una copia de la configuración actual, modifica y guarda los cambios en un archivo local y, luego, implementa esos cambios en tu servicio.

  1. Muestra como YAML y, luego, copia la configuración de tu servicio en un archivo local, por ejemplo service.yaml:

    gcloud kuberun core services describe SERVICE --format yaml

    Reemplaza SERVICE por el nombre de tu servicio de Cloud Run for Anthos.

  2. Realiza los cambios de configuración deseados en el servicio como se describe en las distintas páginas de configuración.

     apiVersion: serving.knative.dev/v1
     kind: Service
     metadata:
       annotations:
         ...
       name: SERVICE
       ...
     spec:
       template:
         metadata:
           annotations:
           ...
           name: REVISION-NAME
    
    • Si implementas la copia en el mismo clúster de Kubernetes, reemplaza SERVICE por el nombre que deseas usar para la copia. Si implementas la copia en un clúster de Kubernetes diferente, puedes usar el mismo nombre.

    • Asegúrate de que el valor de REVISION-NAME comience con el nombre del servicio (SERVICE). Por ejemplo, si el nombre del servicio nuevo es mynewfoo, el nombre de la revisión debe tener el formato mynewfoo-whatever. De manera opcional, borra el valor por completo y se creará un nombre de revisión nuevo de forma automática.

  3. Copia el servicio mediante el siguiente comando:

    gcloud beta run services replace service.yaml
    Usa la marca --region para implementar la copia en una región diferente.

Visualiza más detalles sobre un servicio

Para ver más detalles sobre un servicio, haz lo siguiente:

Console

Para ver los detalles de un servicio, debes hacer lo siguiente:

  1. Implementar en Cloud Run for Anthos en Google Cloud

  2. Hacer clic en el servicio que deseas en la lista de servicios del proyecto que se muestra para abrir la vista de detalles del servicio:

    lista de revisiones

  3. Observa las pestañas REVISIONES (REVISIONS), REGISTROS y DETALLES. En la pestaña de revisiones, se muestra la lista de revisiones, en la pestaña de registros, se muestran los registros del servicio y, en la de detalles, se muestra la configuración actual de autenticación o conectividad

Línea de comandos

Para ver los detalles de un servicio, ejecuta este comando:

gcloud kuberun core services describe SERVICE
Reemplaza SERVICE por el nombre del servicio.

Puedes usar la marca --format para dar formato al resultado. Por ejemplo, como YAML:

gcloud kuberun core services describe SERVICE --format yaml

También puedes usar la marca --format para obtener la URL de servicio:

gcloud kuberun core services describe SERVICE --format='value(status.url)'

Cloud Code

Para ver los detalles de un servicio con Cloud Code, lee las guías de Cloud Run Explorer para IntelliJ y Visual Studio Code.

Para obtener detalles sobre las revisiones de un servicio, consulta Administra revisiones.

Cambia la configuración de la conectividad del servicio

Un servicio de Cloud Run for Anthos en Google Cloud puede tener dos opciones de conexión:

  • Externa, que permite el acceso externo al servicio

  • internal, que restringe el acceso solo a otros servicios de Cloud Run for Anthos en Google Cloud o servicios de tu clúster que usan Istio

Puedes usar Console o la herramienta de línea de comandos de gcloud para cambiar la configuración.

Console

Para cambiar la configuración de conectividad del servicio, debes hacer lo siguiente:

  1. Implementar en Cloud Run for Anthos en Google Cloud

  2. Hacer clic en el servicio que deseas en la lista de servicios del proyecto que se muestra para abrir la vista de detalles del servicio:

  3. Hacer clic en la pestaña Activadores

  4. Seleccionar la configuración que deseas y hacer clic en Guardar

Línea de comandos

Para cambiar la configuración de conectividad del servicio, actualiza el servicio con la configuración de conectividad que deseas:

gcloud kuberun core services update [SERVICE] --connectivity=[OPTION]
  • Reemplaza [SERVICE] por el nombre del servicio que deseas actualizar. Puedes omitir este parámetro por completo, pero se te solicitará el nombre del servicio si lo haces.

  • Reemplaza [OPTION] por internal o external.

Borra servicios existentes

Si borras un servicio, se borrarán todos los recursos relacionados con él, incluidas todas las revisiones de ese servicio, sin importar si entregan tráfico o no.

Cuando se borra un servicio, las imágenes de contenedor que usan las revisiones borradas no se borran de forma automática de Container Registry. Para borrar imágenes de contenedor de Container Registry, consulta Borra imágenes.

Ten en cuenta que la eliminación de un servicio es una acción permanente, es decir, no se puede deshacer ni restablecer. Sin embargo, si borras un servicio y, luego, implementas un servicio nuevo con el mismo nombre en el mismo clúster, este tendrá la misma URL de extremo.

Console

Para borrar un servicio, debes hacer lo siguiente:

  1. Implementar en Cloud Run for Anthos en Google Cloud

  2. Buscar el servicio que deseas borrar en la lista de servicios y hacer clic en su casilla de verificación para seleccionarlo

  3. Hacer clic en BORRAR. Esta acción borra todas las revisiones del servicio

Línea de comandos

Para borrar un servicio, usa el siguiente comando:

gcloud kuberun core services delete [SERVICE]

Reemplaza [SERVICE] por el nombre del servicio.