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 la entrega de Knative.

Crea un Service

Para crear un servicio nuevo y su revisión, implementa una imagen de contenedor en él por primera vez. Consulta Implementa un servicio nuevo para obtener más información sobre la creación de servicios.

Visualiza la lista de servicios en el proyecto

Puedes ver una lista de los servicios disponibles en el proyecto mediante la consola de Google Cloud o Google Cloud CLI:

Console

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

  1. Ve a la entrega de Knative en la consola de Google Cloud:

    Ir a la entrega de Knative

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

Línea de comandos

Para enumerar los servicios del proyecto, ejecuta este comando:

gcloud run services list

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

Copia un servicio

Se puede hacer una copia de un servicio existente mediante la consola de Google Cloud 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. Ve a la entrega de Knative en la consola de Google Cloud:

    Ir a la entrega de Knative

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

    1. Haz clic en 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

Puedes descargar la configuración de un servicio existente en un archivo YAML con el comando gcloud run services describe mediante la marca --format=export. Luego, puedes modificar ese archivo YAML e implementar esos cambios con el comando gcloud run services replace. Debes asegurarte de modificar solo los atributos especificados.

  1. Descarga la configuración del servicio en un archivo llamado service.yaml en el lugar de trabajo local:

    gcloud run services describe SERVICE --format export > service.yaml

    Reemplaza SERVICE por el nombre de tu servicio de entrega de Knative.

  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 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. Ve a la entrega de Knative en la consola de Google Cloud:

    Ir a la entrega de Knative

  2. Haz 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. 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

Sigue estos pasos para ver los detalles de un servicio:

gcloud run 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 run services describe SERVICE --format yaml

Puedes usar --format export para exportar como YAML sin etiquetas o estado generados de forma automática:

gcloud run services describe SERVICE --format export

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

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

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

Cambia la configuración de la conectividad del servicio

Un servicio de entrega de Knative puede tener cualquiera de las siguientes dos opciones de conexión:

  • Externa, que permite el acceso externo al servicio

  • Interna, que restringe el acceso solo a otros servicios del clúster.

Puedes usar Console o Google Cloud CLI para cambiar la configuración.

Console

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

  1. Ve a la entrega de Knative en la consola de Google Cloud:

    Ir a la entrega de Knative

  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 run 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. Ve a la entrega de Knative en la consola de Google Cloud:

    Ir a la entrega de Knative

  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 run services delete [SERVICE]

Reemplaza [SERVICE] por el nombre del servicio.