Creazione di un deployment mediante gcloud o API

In questa pagina viene descritto come creare un deployment. Un deployment è un'instaurazione di un insieme di risorse definite in una configurazione. Devi fornire una configurazione valida nella richiesta per creare il deployment. Un deployment può contenere una serie di risorse, in vari servizi Google Cloud. Quando crei un deployment, Deployment Manager crea tutte le risorse descritte nelle rispettive API Google Cloud.

Prima di iniziare

• Se vuoi utilizzare gli esempi a riga di comando di questa guida, installa lo strumento a riga di comando "gcloud".
• Se vuoi utilizzare gli esempi di API descritti in questa guida, configura l'accesso alle API.
• Crea una configurazione.

Creazione di un deployment

Quando crei un deployment, crei una risorsa Deployment che contiene una raccolta di risorse. Ogni risorsa è definita esplicitamente in una configurazione da te fornita nella richiesta.

gcloud

Con Google Cloud CLI, utilizza il comando deployments create:

gcloud deployment-manager deployments create my-first-deployment \
    --config vm.yaml

Il flag --config è un percorso relativo al file di configurazione YAML.

Per impostazione predefinita, se la configurazione include risorse già presenti nel progetto, queste vengono acquisite dal deployment e possono essere gestite utilizzando il deployment. Se non vuoi acquisire una risorsa, devi utilizzare l'opzione --create-policy, come nel seguente comando gcloud beta:

gcloud beta deployment-manager deployments create my-first-deployment \
    --config vm.yaml --create-policy CREATE

Per informazioni sui criteri che puoi utilizzare quando crei deployment, consulta Configurare i criteri per la creazione di risorse.

Se il deployment è stato creato correttamente, puoi ottenere una descrizione:

gcloud deployment-manager deployments describe my-first-deployment

API

Nell'API, effettua una richiesta insert() con la configurazione fornita in linea, nel corpo della richiesta:

POST https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments

{
 "name": "example-config-with-templates",
 "target": {
  "config": {
   "content": "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20151104\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\n"
  }
 }
}

Se importi modelli, devi anche fornire questi modelli come parte del corpo della richiesta. Ad esempio, la seguente richiesta API ha un target che importa un modello, denominato vm_template.jinja:

POST https://www-www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments

{
 "name": "my-example-config-with-templates-2",
 "target": {
  "config": {
    "content": "imports:\n- path: vm_template.jinja\n\nresources:\n- name: my-vm\n  type: vm_template.jinja"
  },
  "imports": [
   {
    "content": "resources:\n- name: vm-created-by-cloud-config\n  type: compute.v1.instance\n  properties:\n    zone: us-central1-a\n    machineType: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/machineTypes/n1-standard-1\n    disks:\n    - deviceName: boot\n      type: PERSISTENT\n      boot: true\n      autoDelete: true\n      initializeParams:\n        diskName: disk-created-by-cloud-config\n        sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-7-wheezy-v20151104\n    networkInterfaces:\n    - network: https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default",
    "name": "vm_template.jinja"
   }
  ]
 }
}

Nota: quando utilizzi l'API per creare un deployment, il completamento dell'operazione potrebbe richiedere molto tempo. Per le linee guida su come verificare lo stato dell'operazione, scopri come gestire le operazioni a lunga esecuzione.

Configurazione del criterio per la creazione di risorse

Beta

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Quando crei un nuovo deployment, se nel progetto esiste già una risorsa che vuoi creare, questa viene acquisita dal deployment. In questi casi, Deployment Manager non crea una nuova risorsa. Se non vuoi acquisire una risorsa esistente, devi utilizzare il criterio CREATE per il deployment.

Puoi utilizzare i seguenti criteri per creare le risorse:

• CREATE_OR_ACQUIRE: [valore predefinito] Deployment Manager acquisisce le risorse esistenti nel progetto o le crea se non esistono. Per acquisire una risorsa, Deployment Manager controlla nella configurazione le proprietà della risorsa che stai cercando di creare. Se esiste già una risorsa con le stesse proprietà, Deployment Manager la acquisisce come parte del deployment.

  Le proprietà controllate da Deployment Manager dipendono dal tipo di risorsa che stai creando e possono includere:

  • name della risorsa
  • type della risorsa
  • zone o region della risorsa, se applicabile

  Le proprietà fanno parte dell'URL della richiesta API GET relativa alla risorsa. Per vedere quali proprietà vengono utilizzate da Deployment Manager per acquisire una risorsa, consulta la documentazione dell'API per il metodo GET della risorsa. Ad esempio, per le istanze di Compute Engine, l'URL di richiesta per il metodo instances.get include resourceId (name nella tua configurazione), zone e project.

  Nota: se vuoi acquisire una risorsa, devi fornire tutte le relative proprietà, come se stessi creando una risorsa.

• CREATE: Deployment Manager crea risorse che non esistono. Se una delle risorse nella tua configurazione esiste già nel progetto, il deployment non va a buon fine.

• ACQUIRE - Deployment Manager acquisisce risorse già esistenti, utilizzando gli stessi criteri di CREATE_OR_ACQUIRE.

  Utilizza il criterio ACQUIRE se hai già un certo numero di risorse nel progetto e vuoi gestirle insieme, come un unico deployment.

  Nel modello o nella configurazione, devi fornire le proprietà richieste per queste risorse come se le stessi creando. Se una qualsiasi delle risorse nella tua configurazione non esiste nel progetto, il deployment non va a buon fine.

  Avviso: non acquisire risorse che fanno già parte di un altro deployment. In caso contrario, qualsiasi modifica apportata a un deployment può causare comportamenti imprevisti nelle risorse nell'altro deployment.

Elenco dei tuoi deployment

Visualizza un elenco dei tuoi deployment nella console Google Cloud, nell'API o in Google Cloud CLI.

Console

Vai alla pagina Deployment nella console Google Cloud.

gcloud

Con Google Cloud CLI, utilizza il sottocomando deployments list:

gcloud deployment-manager deployments list

API

Nell'API, effettua una richiesta GET vuota alla raccolta Deployment:

GET https://www.googleapis.com/deploymentmanager/v2beta1/projects/myproject/global/deployments

Passaggi successivi

• Aggiungi etichette al deployment.
• Aggiorna il deployment.