Guía de inicio rápido

En esta guía de inicio rápido se usará Google Cloud Deployment Manager para implementar una instancia de máquina virtual. La máquina virtual es un recurso, que se agrega para implementar un archivo de configuración. Después de crear un archivo de configuración, puedes utilizarlo para crear una implementación, que es una colección de recursos que puedes crear o administrar de manera conjunta.

Las implementaciones pueden contener decenas de recursos de varios servicios de Google Cloud, y puedes utilizar Deployment Manager para administrarlos desde un solo archivo.

En esta guía de inicio rápido se explica cómo crear un archivo de configuración básica y utilizar ese archivo para crear una implementación. Para completar este instructivo, debes sentirte cómodo con la ejecución de comandos en una terminal de Linux, macOS o Windows.

Puedes seguir la guía de inicio rápido en Cloud Shell, donde puedes editar la configuración de muestra e implementar los recursos sin instalar nada en la computadora. Si deseas seguir el instructivo en tu propia computadora, pasa a la siguiente sección.

Guía de inicio rápido en Cloud Shell

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. Selecciona o crea un proyecto de GCP.

    Ir a la página Administrar recursos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita las Deployment Manager y Compute Engine API necesarias.

    Habilita las API

  5. En tu estación de trabajo, instala la herramienta de línea de comandos de gcloud.
  6. Configura la herramienta de línea de comandos de gcloud para utilizar el proyecto. En el siguiente comando, reemplaza [MY_PROJECT] por el ID del proyecto:
    gcloud config set project [MY_PROJECT]

Define los recursos

Describe los recursos en un archivo de configuración, que se escribe en la sintaxis YAML.

  1. Copia la configuración de muestra a continuación y pégala en un editor de texto.

    # Copyright 2016 Google Inc. All rights reserved.
    #
    # Licensed under the Apache License, Version 2.0 (the "License");
    # you may not use this file except in compliance with the License.
    # You may obtain a copy of the License at
    #
    #     https://www.apache.org/licenses/LICENSE-2.0
    #
    # Unless required by applicable law or agreed to in writing, software
    # distributed under the License is distributed on an "AS IS" BASIS,
    # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    # See the License for the specific language governing permissions and
    # limitations under the License.
    
    # Put all your resources under `resources:`. For each resource, you need:
    # - The type of resource. In this example, the type is a Compute VM instance.
    # - An internal name for the resource.
    # - The properties for the resource. In this example, for VM instances, you add
    #   the machine type, a boot disk, network information, and so on.
    #
    # For a list of supported resources,
    # see https://cloud.google.com/deployment-manager/docs/configuration/supported-resource-types.
    resources:
    - type: compute.v1.instance
      name: quickstart-deployment-vm
      properties:
        # The properties of the resource depend on the type of resource. For a list
        # of properties, see the API reference for the resource.
        zone: us-central1-f
        # Replace [MY_PROJECT] with your project ID
        machineType: https://www.googleapis.com/compute/v1/projects/[MY_PROJECT]/zones/us-central1-f/machineTypes/f1-micro
        disks:
        - deviceName: boot
          type: PERSISTENT
          boot: true
          autoDelete: true
          initializeParams:
            # Replace [FAMILY_NAME] with the image family name.
            # See a full list of image families at https://cloud.google.com/compute/docs/images#os-compute-support
            sourceImage: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/family/[FAMILY_NAME]
        # Replace [MY_PROJECT] with your project ID
        networkInterfaces:
        - network: https://www.googleapis.com/compute/v1/projects/[MY_PROJECT]/global/networks/default
          # Access Config required to give the instance a public IP address
          accessConfigs:
          - name: External NAT
            type: ONE_TO_ONE_NAT
    

    Este archivo de configuración básica describe una implementación que contiene una instancia de máquina virtual con las siguientes propiedades:

    • Tipo de máquina: f1-micro
    • Familia de imágenes: debian-9
    • Zona: us-central1-f
    • Disco persistente raíz: boot
    • Una dirección IP externa asignada de forma aleatoria
  2. Reemplaza las siguientes variables de marcador de posición:

    • Reemplaza [MY_PROJECT] por el ID del proyecto
    • Reemplaza [FAMILY_NAME] por la familia de imágenes debian-9
  3. Guarda el archivo como vm.yaml.

Implementa los recursos

A fin de implementar los recursos, utiliza la herramienta de línea de comandos de gcloud para crear una implementación nueva con el uso del archivo de configuración:

gcloud deployment-manager deployments create quickstart-deployment --config vm.yaml

Si la implementación se realiza de manera correcta, recibirás un mensaje similar al siguiente ejemplo:

Create operation operation-1432319707382-516afeb5d00f1-b864f0e7-b7103978 completed successfully.
NAME                    TYPE                STATE      ERRORS
quickstart-deployment   compute.v1.instance COMPLETED  -

Ahora tienes tu primera implementación.

Verifica la implementación nueva

Para verificar el estado de la implementación, ejecuta el siguiente comando:

gcloud deployment-manager deployments describe quickstart-deployment

Verás una descripción de la implementación, lo que incluye la hora de inicio y finalización, los recursos creados y cualquier advertencia o error.

fingerprint: xmVVeTtPq-5rr8F-vWFlrg==
id: '54660732508021769'
insertTime: '2016-03-09T04:45:26.032-08:00'
manifest: https://www.googleapis.com/deploymentmanager/v2/projects/myproject/global/deployments/my-first-deployment/manifests/manifest-1457527526037
name: quickstart-deployment
operation:
  endTime: '2016-03-09T04:46:19.480-08:00'
  id: '8993923014899639305'
  kind: deploymentmanager#operation
  name: operation-1457527525951-52d9d126f4618-f1ca6e72-3404bd3b
  operationType: insert
  progress: 100
  startTime: '2016-03-09T04:45:27.275-08:00'
  status: DONE
...
resources:
NAME                     TYPE                 STATE      ERRORS
quickstart-deployment-vm  compute.v1.instance  COMPLETED  -

Revisa los recursos

Una vez que hayas creado la implementación, puedes revisar los recursos en Cloud Console.

  1. Para ver una lista de las implementaciones, abre la página de Deployment Manager en la consola. Ir a la página de Deployment Manager

  2. Para ver los recursos en la implementación, haz clic en quickstart-deployment. Se abrirá la descripción general de la implementación, con información sobre la implementación y los recursos que forman parte de la implementación.

  3. Para ver información sobre la VM, haz clic en quickstart-deployment-vm.

Limpiar

Para evitar que se apliquen cargos a tu cuenta de GCP por los recursos que se utilizan en esta guía de inicio rápido, haz lo siguiente:

gcloud deployment-manager deployments delete quickstart-deployment

Escribe y en el indicador:

The following deployments will be deleted:
- quickstart-deployment

Do you want to continue (y/N)?

La implementación y los recursos que creaste se borran de forma permanente.

Pasos siguientes

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Cloud Deployment Manager