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 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 l'infrastruttura di servizi, ad esempio l'API Gmail e l'API Spanner. Un servizio gestito ha solo due proprietà immutabili, un nome del servizio e un progetto producer, ma l'implementazione di un servizio gestito può fornire un'ampia gamma di funzionalità. Ad esempio, l'API Cloud Storage fornisce archiviazione di oggetti su scala mondiale a milioni di sviluppatori e aziende.

Un servizio gestito ha una serie di consumer di servizi, una cronologia di configurazioni dei servizi immutabili e una cronologia di implementazioni di servizi immutabili. Le configurazioni del servizio a cui fa riferimento l'ultima implementazione 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 la pagina google.api.Service.

In questa pagina spiegheremo come creare e gestire i cicli di vita dei servizi. Per ulteriori informazioni sulla gestione del servizio, consulta le guide illustrative.

Creazione di un servizio

Per creare un servizio, devi completare i seguenti passaggi.

  1. Installa e inizializza gcloud CLI sul tuo computer.

  2. Crea un progetto producer dedicato per ospitare il tuo servizio. Un progetto dedicato offre la massima sicurezza e isolamento per il tuo servizio. Inoltre, permette di trasferire la proprietà del servizio a un altro team o a un'altra azienda.

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

  4. Abilitare la fatturazione Cloud per il tuo progetto. Per integrare il tuo servizio con Service Infrastructure, dipenderai da 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 di servizio vuota:

    gcloud endpoints services deploy endpointsapis.yaml

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

Elenco dei servizi

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

gcloud endpoints services list --project endpointsapis

Descrizione di un servizio

Per descrivere un servizio e la sua 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 per l'eliminazione di 30 giorni.

Annullare l'eliminazione di un servizio

Puoi annullare l'eliminazione di un servizio all'interno del 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 dei servizi per raggiungere lo stato desiderato. Le configurazioni dei servizi vengono utilizzate per configurare i servizi dell'infrastruttura Google Cloud a supporto del servizio, tra cui fatturazione Cloud, Cloud Logging, Cloud Monitoring e Identity and Access Management.

Per ulteriori informazioni sulle configurazioni dei servizi, consulta Gestione delle configurazioni dei servizi. Per ulteriori informazioni sulle implementazioni dei servizi, consulta Gestione delle implementazioni dei servizi.