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:
Ve a la entrega de Knative en la consola de Google Cloud:
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:
Ve a la entrega de Knative en la consola de Google Cloud:
Selecciona el servicio que deseas copiar de la lista de servicios que se muestra para tu proyecto:
Haz clic en Copiar.
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.
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.
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.
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 formatomynewfoo-whatever
. De manera opcional, borra el valor por completo y se creará un nombre de revisión nuevo de forma automática.
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:
Ve a la entrega de Knative en la consola de Google Cloud:
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:
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
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:
Ve a la entrega de Knative en la consola de Google Cloud:
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:
Hacer clic en la pestaña Activadores
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]
porinternal
oexternal
.
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:
Ve a la entrega de Knative en la consola de Google Cloud:
Buscar el servicio que deseas borrar en la lista de servicios y hacer clic en su casilla de verificación para seleccionarlo
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.