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:
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 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:
Selecciona el servicio que deseas copiar de la lista de servicios que se muestra para tu proyecto:
Haz clic en Copy (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
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.
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.
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 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:
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 kuberun core services describe SERVICEReemplaza 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:
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 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]
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:
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 kuberun core services delete [SERVICE]
Reemplaza [SERVICE]
por el nombre del servicio.