Administrar los ciclos de vida de servicios

En esta página, se describe cómo administrar los ciclos de vida de los servicios administrados mediante los comandos gcloud endpoints services del SDK de Cloud.

Para casos prácticos avanzados, puedes usar la API de Administración de servicios para administrar servicios de manera programática. Para obtener más información, consulta Comienza a usar la API de Administración de servicios.

Introducción

Un servicio administrado es un recurso simple que representa de forma lógica un servicio integrado a Service Infrastructure, como la API de Gmail y la API de Spanner. Un servicio administrado en sí solo tiene dos propiedades inmutables, un nombre de servicio y un proyecto de productor, pero la implementación de un servicio administrado puede proporcionar una amplia gama de funcionalidades. Por ejemplo, la API de Cloud Storage proporciona almacenamiento de objetos a escala mundial para millones de desarrolladores y empresas.

Un servicio administrado tiene un conjunto de consumidores de servicios, un historial de configuraciones del servicio inmutable, y un historial de lanzamientos de servicio inmutables. Las opciones de configuración del servicio a las que se hace referencia en el lanzamiento del servicio más reciente 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 ver la especificación, consulta google.api.Service.

En esta página, describiremos cómo crear y administrar los ciclos de vida del servicio. Para obtener más información sobre la administración de servicios, consulta las Guías prácticas.

Crea un servicio

Para crear un servicio, debes completar los siguientes pasos.

  1. Instala e inicializa el SDK de Cloud en tu computadora.

  2. Crea un proyecto de productor dedicado para alojar tu servicio. Un proyecto dedicado 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 la API de Administración de servicios y la API de Control de servicios para tu proyecto.

  4. Habilita la Facturación de Cloud para tu proyecto. Para integrar tu servicio a Service Infrastructure, dependes de varios productos pagos de Google Cloud, incluidos la API de Control de servicios, la API de Cloud Logging y la API de Cloud Monitoring.

  5. Prepara un archivo yaml de configuración de servicio simple 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 de gcloud para crear tu servicio mediante la implementación de una configuración de servicio en blanco:

    gcloud endpoints services deploy endpointsapis.yaml
    

El proceso de creación del servicio tarda alrededor de un minuto. A continuación, deberías poder ver tu servicio en la página Endpoints de Google Cloud Console.

Genera una lista de servicios

Para mostrar una lista de los servicios de un proyecto, puedes usar el siguiente comando:

gcloud endpoints services list --project endpointsapis

Describe un servicio

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

gcloud endpoints services describe endpointsapis.appspot.com

Borra un servicio

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

gcloud endpoints services delete endpointsapis.appspot.com

NOTA: Cada servicio tiene una retención de eliminación obligatoria de 30 días.

Recupera un servicio

Puedes recuperar un servicio dentro de su período de retención con el siguiente comando:

gcloud endpoints services undelete endpointsapis.appspot.com

Próximos pasos

La API de Administración de servicios usa un modelo declarativo para administrar servicios. Después de crear el servicio, debes enviar la configuración inmutable y los lanzamientos de servicio para lograr el estado deseado. Las opciones de configuración del servicio se usan para configurar los servicios de infraestructura de Google Cloud a fin de admitir tu servicio, como la Facturación de Cloud, Cloud Logging, Cloud Monitoring y la administración de identidades y accesos.

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