Gestione dei cicli di vita dei servizi

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

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

Introduzione

Un servizio gestito è una risorsa semplice che rappresenta logicamente un servizio integrato con Service Infrastructure, ad esempio l'API Gmail e l'API Spanner. Un servizio gestito stesso ha solo due proprietà immutabili, un nome del servizio e un progetto del produttore, 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 consumatori di servizi, una cronologia di immutabili configurazioni di servizi e una cronologia di immutabili implementazioni di servizi. Le configurazioni di servizio a cui fa riferimento l'ultimo aggiornamento del servizio rappresentano lo stato attuale del servizio, che copre tutti gli aspetti del servizio, dal nome visualizzato alle definizioni delle metriche fino ai limiti di frequenza. Per la specifica, consulta google.api.Service.

In questa pagina descriveremo come creare e gestire i cicli di vita dei servizi. Per ulteriori informazioni 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 di producer dedicato per ospitare il servizio. Un progetto dedicato offre la massima sicurezza e isolamento per il tuo servizio. Inoltre, ti consente di trasferire la proprietà del servizio a un altro team o addirittura a un'altra azienda.

  3. Abilita le API Service Management e 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 per il tuo 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

Il processo di creazione del servizio richiede circa un minuto. Dopodiché, dovresti essere in grado di vedere il tuo servizio elencato nella pagina Endpoint della console Google Cloud.

Servizi di elenco

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

gcloud endpoints services list --project endpointsapis

Descrivere un servizio

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

gcloud endpoints services describe endpointsapis.appspot.com

Eliminazione di un servizio

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

gcloud endpoints services delete endpointsapis.appspot.com

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

Annullare 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 di configurazioni e implementazioni immutabili del servizio per raggiungere lo stato desiderato del servizio. Le configurazioni del servizio vengono utilizzate per configurare i servizi di infrastruttura Google Cloud in modo da supportare il servizio, tra cui Fatturazione Cloud, Cloud Logging, Cloud Monitoring e Identity and Access Management.

Per ulteriori informazioni sulle configurazioni dei servizi, consulta Gestire le configurazioni dei servizi. Per ulteriori informazioni sull'implementazione dei servizi, consulta Gestire l'implementazione dei servizi.