Gestionar servicios

En esta página se describe cómo crear un servicio y ver información sobre él. Los servicios son los recursos principales de Knative Serving.

Crear un servicio

Para crear un servicio y su revisión, debes desplegar una imagen de contenedor en él por primera vez. Consulta Implementar un nuevo servicio para obtener más información sobre cómo crear servicios.

Ver la lista de servicios de tu proyecto

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

Consola

Para ver la lista de servicios, sigue estos pasos:

  1. Ve a Knative Serving en la Google Cloud consola:

    Ir a Knative serving

  2. Consulta la lista de servicios que se muestra en tu proyecto:

Línea de comandos

Para enumerar los servicios de tu proyecto, sigue estos pasos:

gcloud run services list

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

Copiar un servicio

Puedes hacer una copia de un servicio que ya tengas con la consola de Google Cloud o con YAML. Puedes cambiar lo que quieras de la copia, como el nombre y la región.

Consola

Para copiar un servicio, sigue estos pasos:

  1. Ve a Knative Serving en la Google Cloud consola:

    Ir a Knative serving

  2. Selecciona el servicio del que quieras copiar de la lista de servicios de tu proyecto:

    1. Haz clic en Copiar.

    2. En la página de copia del servicio, define o cambia los valores que quieras modificar, como la región, etc. Si vas a mantener la misma región, debes proporcionar un nombre nuevo para el servicio.

    3. Haga clic en Crear para hacer una copia e implementarla con el nuevo nombre de servicio.

YAML

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

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

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

    Sustituye SERVICE por el nombre de tu servicio de Knative.

  2. Realice los cambios de configuración que quiera en el servicio, tal 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 vas a desplegar la copia en el mismo clúster de Kubernetes, sustituye SERVICE por el nombre que quieras usar para la copia. Si vas a desplegar la copia en otro clúster de Kubernetes, puedes usar el mismo nombre.

    • Asegúrate de que el valor de REVISION-NAME empiece por el nombre del servicio (SERVICE). Por ejemplo, si el nuevo nombre del servicio es mynewfoo, el nombre de la revisión debe tener el formato mynewfoo-whatever. También puedes eliminar el valor por completo y se creará un nuevo nombre de revisión automáticamente.

  3. Copia el servicio con el siguiente comando:

    gcloud run services replace service.yaml

    Usa la marca --region para implementar la copia en otra región.

Ver más detalles sobre un servicio

Para ver más detalles sobre un servicio,

Consola

Para ver los detalles de un servicio, sigue estos pasos:

  1. Ve a Knative Serving en la Google Cloud consola:

    Ir a Knative serving

  2. En la lista de servicios de tu proyecto, haz clic en el que quieras para abrir la vista de detalles del servicio:

  3. Fíjate en las pestañas REVISIONES, REGISTROS y DETALLES. En la pestaña Revisiones se muestra la lista de revisiones, en la pestaña Registros se muestran los registros de servicio y en la pestaña Detalles se muestran los ajustes de autenticación o conectividad actuales.

Línea de comandos

Para ver los detalles de un servicio, sigue estos pasos: 

gcloud run services describe SERVICE
 Sustituye SERVICE por el nombre del servicio.

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

gcloud run services describe SERVICE --format yaml

Puedes usar --format export para exportar como YAML sin etiquetas ni estados generados automáticamente:

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 más información sobre las revisiones de un servicio, consulta Gestionar revisiones.

Cambiar los ajustes de conectividad de los servicios

Un servicio de Knative Serving puede tener una de estas dos opciones de conexión:

  • externo, que permite el acceso externo a tu servicio

  • Interno: restringe el acceso solo a otros servicios de tu clúster.

Puedes usar la consola o la CLI de Google Cloud para cambiar los ajustes.

Consola

Para cambiar los ajustes de conectividad de los servicios, sigue estos pasos:

  1. Ve a Knative Serving en la Google Cloud consola:

    Ir a Knative serving

  2. En la lista de servicios de tu proyecto, haz clic en el que quieras para abrir la vista de detalles del servicio.

  3. Haz clic en la pestaña Activadores.

  4. Selecciona el ajuste que quieras y haz clic en Guardar.

Línea de comandos

Para cambiar los ajustes de conectividad de un servicio, actualízalo con el ajuste de conectividad que quieras:

gcloud run services update [SERVICE] --connectivity=[OPTION]

  • Sustituye [SERVICE] por el nombre del servicio que vas a actualizar. Puedes omitir este parámetro por completo, pero se te pedirá el nombre del servicio si lo haces.

  • Sustituye [OPTION] por internal o external.

Eliminar servicios

Si eliminas un servicio, se borrarán todos los recursos relacionados con él, incluidas todas las revisiones del servicio, tanto si están sirviendo tráfico como si no.

Cuando se elimina un servicio, las imágenes de contenedor que usan las revisiones eliminadas no se eliminan automáticamente de Container Registry. Para eliminar imágenes de contenedor de Container Registry, consulta Eliminar imágenes.

Ten en cuenta que la eliminación de un servicio es permanente: no se puede deshacer ni restaurar. Sin embargo, si después de eliminar un servicio, implementas un servicio nuevo con el mismo nombre en el mismo clúster, tendrá la misma URL de endpoint.

Consola

Para eliminar un servicio, sigue estos pasos:

  1. Ve a Knative Serving en la Google Cloud consola:

    Ir a Knative serving

  2. Busca el servicio que quieras eliminar en la lista de servicios y marca la casilla correspondiente para seleccionarlo.

  3. Haz clic en ELIMINAR. Se eliminarán todas las revisiones del servicio.

Línea de comandos

Para eliminar un servicio, usa el comando:

gcloud run services delete [SERVICE]

Sustituye [SERVICE] por el nombre de tu servicio.