Esta documentación es para la versión más reciente de Knative serving, que usa flotas y Anthos Service Mesh. Obtén más información.

La versión anterior (Cloud Run for Anthos) se archivó, pero la documentación permanece disponible para los usuarios existentes.

Versiones disponibles

Más reciente
Archivo

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 Knative serving.

Crear un servicio

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 Knative serving en la consola de Google Cloud:

Ir a Knative serving
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 Knative serving en la consola de Google Cloud:

Ir a Knative serving
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.

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

Ir a Knative serving
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:
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 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 de 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 Knative serving puede tener 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 Knative serving en la consola de Google Cloud:

Ir a Knative serving
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] 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:

Ve a Knative serving en la consola de Google Cloud:

Ir a Knative serving
Buscar el servicio que deseas borrar en la lista de servicios y hacer clic en su casilla de verificación para seleccionarlo
Haz 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.