Gestione dei cicli di vita dei servizi

Questa pagina descrive come gestire i cicli di vita di servizi gestiti con Google Cloud CLI gcloud endpoints services tramite comandi SQL.

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 Infrastruttura, ad esempio API Gmail e 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 archiviazione di oggetti su scala globale per milioni di sviluppatori e aziende.

Un servizio gestito ha un insieme di consumatori di servizi, una cronologia di configurazioni di servizi immutabili e una cronologia di implementazioni di servizi immutabili. Le configurazioni di servizio a cui fa riferimento l'ultima implementazione del servizio lo stato attuale del servizio, che ne copre tutti gli aspetti, ad esempio: il nome visualizzato alle definizioni delle metriche e 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 del servizio, consulta Guide illustrative.

crea 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 indirizzo che offra la massima sicurezza e isolamento al tuo servizio. Ti consente anche di trasferire la proprietà del tuo servizio a un altro o un'altra azienda.

  3. Abilitare 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, dipenderai da diversi servizi Google Cloud a pagamento tra cui API Service Control, API Cloud Logging e l'API Cloud Monitoring.

  5. Prepara un file YAML di configurazione del servizio semplice 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 tuo servizio eseguendo il deployment di un servizio vuoto configurazione:

    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.

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 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: il periodo di conservazione dell'eliminazione di ogni servizio è obbligatorio per 30 giorni.

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 tuo 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.