Gestione dei cicli di vita dei servizi

Questa pagina descrive come gestire i cicli di vita dei servizi gestiti utilizzando i comandi gcloud endpoints services di Google Cloud CLI.

Per i casi d'uso avanzati, puoi utilizzare l'API Service Management per gestire i servizi in modo programmatico. Per saperne di più, consulta la guida introduttiva all'API Service Management.

Introduzione

Un servizio gestito è una risorsa semplice che rappresenta logicamente un servizio integrato con Service Infrastructure, come l'API Gmail e l'API Spanner. Un servizio gestito ha solo due proprietà immutabili, un nome del servizio e un progetto del producer, ma l'implementazione di un servizio gestito può fornire un'ampia gamma di funzionalità. Ad esempio, l'API Cloud Storage fornisce uno spazio di archiviazione di oggetti su scala planetaria per milioni di sviluppatori e aziende.

Un servizio gestito ha un insieme di consumer di servizi, una cronologia delle configurazioni di serviziimmutabili, e una cronologia delle implementazioni di serviziimmutabili. Le configurazioni del servizio a cui fa riferimento l'ultimo rilascio del servizio rappresentano lo stato attuale del servizio, che copre tutti gli aspetti del servizio, dal nome visualizzato alle definizioni delle metriche ai limiti di frequenza. Per la specifica, vedi google.api.Service.

In questa pagina descriveremo come creare e gestire i cicli di vita dei servizi. Per saperne di più sulla gestione dei servizi, consulta le guide pratiche.

Crea un servizio

Per creare un servizio, devi completare i seguenti passaggi.

  1. Installa e inizializza gcloud CLI sul computer.

  2. Crea un progetto del producer dedicato per ospitare il tuo servizio. Un progetto dedicato offre la migliore sicurezza e il miglior isolamento per il tuo servizio. Ti consente inoltre di trasferire la proprietà del tuo servizio a un altro team o persino a un'altra azienda.

  3. Abilita l'API Service Management e l'API Service Control per il tuo progetto.

  4. Abilita la fatturazione Cloud per il tuo progetto. Per integrare il tuo servizio con Service Infrastructure, dovrai utilizzare diversi prodotti Google Cloud a pagamento, tra cui l'API Service Control, l'API Cloud Logging e l'API Cloud Monitoring.

  5. Prepara un semplice file YAML di configurazione del servizio come segue:

    # 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. Esegui il comando gcloud per creare il servizio eseguendo il deployment di una configurazione del servizio vuota:

    gcloud endpoints services deploy endpointsapis.yaml

La procedura di creazione del servizio richiede circa un minuto. Dopodiché, dovresti essere in grado di visualizzare il tuo servizio elencato nella pagina Endpoints della Google Cloud console.

Schede dei servizi

Per elencare i servizi in un progetto, puoi utilizzare il seguente comando:

gcloud endpoints services list --project endpointsapis

Descrivi un servizio

Per descrivere un servizio e la relativa configurazione, puoi utilizzare il seguente comando:

gcloud endpoints services describe endpointsapis.appspot.com

Elimina un servizio

Se non hai più bisogno di un servizio, puoi eliminarlo utilizzando il seguente comando:

gcloud endpoints services delete endpointsapis.appspot.com

NOTA: ogni servizio ha un periodo di conservazione obbligatorio di 30 giorni per l'eliminazione.

Annulla l'eliminazione di un servizio

Puoi annullare l'eliminazione di un servizio entro il periodo di conservazione utilizzando il seguente comando:

gcloud endpoints services undelete endpointsapis.appspot.com

Passaggi successivi

L'API Service Management utilizza un modello dichiarativo per la gestione dei servizi. Dopo aver creato il servizio, devi eseguire il push delle configurazioni di servizi immutabili e delle implementazioni di servizi per raggiungere lo stato desiderato del servizio. Le configurazioni dei servizi vengono utilizzate per configurare i servizi di infrastruttura Google Cloud a supporto del tuo servizio, tra cui fatturazione Cloud, Cloud Logging, Cloud Monitoring e Identity and Access Management.

Per saperne di più sulle configurazioni dei servizi, consulta Gestire le configurazioni dei servizi. Per saperne di più sulle implementazioni dei servizi, consulta Gestire le implementazioni dei servizi.