Gestionar ciclos de vida de servicios

En esta página se describe cómo gestionar los ciclos de vida de los servicios gestionados mediante los comandos de la CLI de Google Cloud gcloud endpoints services.

Para casos prácticos avanzados, puedes usar la API Service Management para gestionar servicios de forma programática. Para obtener más información, consulta el artículo Empezar a usar la API Service Management.

Introducción

Un servicio gestionado es un recurso sencillo que representa lógicamente un servicio integrado con Service Infrastructure, como la API de Gmail y la API de Spanner. Un servicio gestionado solo tiene dos propiedades inmutables: un nombre de servicio y un proyecto productor. Sin embargo, la implementación de un servicio gestionado puede proporcionar una amplia gama de funciones. Por ejemplo, la API Cloud Storage proporciona almacenamiento de objetos a escala planetaria a millones de desarrolladores y empresas.

Un servicio gestionado tiene un conjunto de consumidores de servicios, un historial de configuraciones de servicios inmutables y un historial de lanzamientos de servicios inmutables. Las configuraciones de servicio a las que hace referencia el último lanzamiento del servicio representan el estado actual del servicio, que abarca todos los aspectos del servicio, desde el nombre visible hasta las definiciones de métricas y los límites de frecuencia. Para consultar las especificaciones, ve a google.api.Service.

En esta página se describe cómo crear y gestionar los ciclos de vida de tus servicios. Para obtener más información sobre la gestión de servicios, consulta las guías prácticas.

Crear un servicio

Para crear un servicio, debes seguir estos pasos.

  1. Instala e inicializa gcloud CLI en tu ordenador.

  2. Crea un proyecto de productor específico para alojar tu servicio. Un proyecto específico proporciona la mejor seguridad y aislamiento para tu servicio. También te permite transferir la propiedad de tu servicio a otro equipo o incluso a otra empresa.

  3. Habilita las APIs Service Management y Service Control en tu proyecto.

  4. Habilita la facturación de Cloud en tu proyecto. Para integrar tu servicio con Service Infrastructure, dependerás de varios productos de pago de Google Cloud, como la API Service Control, la API Cloud Logging y la API Cloud Monitoring.

  5. Prepara un archivo yaml de configuración de servicio sencillo para tu servicio de la siguiente manera:

    # Filename: endpointsapis.yaml
type: google.api.Service
config_version: 3
# Update the next line to use your own service name.
name: endpointsapis.appspot.com
# Update the next line to use your own producer project id.
producer_project_id: endpointsapis

  6. Ejecuta el comando gcloud para crear tu servicio desplegando una configuración de servicio en blanco:

    gcloud endpoints services deploy endpointsapis.yaml

El proceso de creación del servicio tarda aproximadamente un minuto. Después, deberías poder ver tu servicio en la página Endpoints de la consola de Google Cloud.

Mostrar servicios

Para enumerar los servicios de un proyecto, puedes usar el siguiente comando:

gcloud endpoints services list --project endpointsapis

Describir un servicio

Para describir un servicio y su configuración, puedes usar el siguiente comando:

gcloud endpoints services describe endpointsapis.appspot.com

Eliminar un servicio

Si ya no necesitas un servicio, puedes eliminarlo con el siguiente comando:

gcloud endpoints services delete endpointsapis.appspot.com

NOTA: Todos los servicios tienen un periodo de conservación de 30 días obligatorio.

Restaurar un servicio

Puedes restaurar un servicio dentro de su periodo de conservación con el siguiente comando:

gcloud endpoints services undelete endpointsapis.appspot.com

Pasos siguientes

La API Service Management usa un modelo declarativo para la gestión de servicios. Una vez creado el servicio, debes enviar configuraciones de servicio inmutables y lanzamientos de servicio para alcanzar el estado deseado del servicio. Las configuraciones de tu servicio se usan para configurar los servicios de infraestructura de Google Cloud que admiten tu servicio, como Facturación de Cloud, Cloud Logging, Cloud Monitoring y Gestión de Identidades y Accesos.

Para obtener más información sobre las configuraciones de servicios, consulta Gestionar configuraciones de servicios. Para obtener más información sobre los lanzamientos de servicios, consulta Gestionar lanzamientos de servicios.