Lab de configuración rápida de AlloyDB

1. Descripción general

En este codelab, demostraremos un método simple y fácil de usar para configurar AlloyDB.

Qué compilarás

Como parte de esto, crearás una instancia y un clúster de AlloyDB junto con todas sus configuraciones de red requeridas en una instalación con un solo clic, y también aprenderás a configurarlo rápidamente en tus proyectos futuros.

Requisitos

• Un navegador, como Chrome o Firefox.
• Un proyecto de Google Cloud con facturación habilitada.

2. Antes de comenzar

Crear proyecto

1. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
2. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información para verificar si la facturación está habilitada en un proyecto.

Si estás probando los servicios de Google Cloud y quieres créditos de prueba para comenzar, puedes configurar una cuenta de facturación de prueba con el vínculo de crédito de facturación de prueba de GCP: https://bit.ly/ez-alloydb1

¿Cómo canjeo créditos con este vínculo? Referir.

Activa Cloud Shell

3. Usarás Cloud Shell, un entorno de línea de comandos que se ejecuta en Google Cloud. Haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.

• Una vez que te conectes a Cloud Shell, verifica que ya te autenticaste y que el proyecto se configuró con tu ID del proyecto con el siguiente comando:

gcloud auth list

• Si no se autenticó, ejecuta el siguiente comando:

gcloud auth login

• En Cloud Shell, ejecuta el siguiente comando para confirmar que el comando gcloud conoce tu proyecto.

gcloud config list project

• Si tu proyecto no está configurado, usa el siguiente comando para hacerlo:

gcloud config set project <YOUR_PROJECT_ID>

Habilita las APIs y otorga permisos

4. Habilita las APIs necesarias:

Sigue el vínculo y habilita las APIs.

Como alternativa, puedes usar el comando de gcloud para esto. Consulta la documentación para ver los comandos y el uso de gcloud.

5. Otorga los roles necesarios para crear y configurar la instancia de AlloyDB

Si estás en tu propio entorno de desarrollo o tienes acceso de propietario o administrador al proyecto, no necesitarás realizar este paso, ya que tu principal (como propietario) ya tendrá estos permisos. De lo contrario, sigue este paso.

Para obtener los permisos que necesitas para crear una base de datos de AlloyDB y conectarte a ella, otorga los siguientes roles de IAM en tu proyecto:

• Administrador de red de Compute (roles/compute.networkAdmin)
• Administrador de AlloyDB (roles/alloydb.admin)

Para hacer lo siguiente:

Ve a la página de IAM, selecciona tu proyecto, ve a la cuenta principal, edítala con el ícono de lápiz en la esquina derecha (o, si no hay ninguno, agrega un principal nuevo haciendo clic en el botón Otorgar acceso) y asigna los roles mencionados anteriormente eligiéndolos uno por uno, y guarda los cambios. Una vez que se sincronicen los permisos, todo estará listo.

Estos son los permisos exactos que se requieren en segundo plano para crear una base de datos de AlloyDB y conectarse a ella:

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• Alloydb.clusters.create
• Alloydb.instances.create
• Alloydb.instances.login

Bien, ahora pasemos a la configuración.

3. Configuración de AlloyDB

Creemos un clúster y una instancia de AlloyDB junto con las configuraciones de red.

1. Ejecuta los siguientes comandos desde tu terminal de Google Cloud Shell para clonar el repo en un directorio raíz y navegar a la carpeta del proyecto clonado:

# 1. Clone the repository
git clone https://github.com/GoogleCloudPlatform/devrel-demos.git

# 2. Navigate to the project directory
cd devrel-demos/infrastructure/easy-alloydb-setup

2. Una vez que se complete este paso, el repo se clonará en tu editor local de Cloud Shell y podrás ejecutar el siguiente comando desde la carpeta del proyecto (es importante que te asegures de estar en el directorio del proyecto):

sh run.sh

3. Ahora usa la IU (puedes encontrar el vínculo en los registros de la terminal, hacer clic en él o navegar haciendo clic en el vínculo "preview on web" en la terminal.
4. Ingresa los detalles del ID del proyecto, el clúster y los nombres de las instancias para comenzar.

Verás la pestaña "Vincular cuenta de facturación de prueba" en la IU. Esto es útil si usas el vínculo de crédito de prueba que se proporciona en la sección "Crea un proyecto" del paso 2 ("Antes de comenzar") del codelab para vincular una cuenta de facturación de PRUEBA activa a tu proyecto de Google Cloud.

5. Ve a tomar un café mientras se desplazan los registros. Aquí puedes leer cómo se hace esto en segundo plano.

Si quieres probarlo de forma local o desde cualquier lugar, ve a la instancia de AlloyDB, haz clic en "EDITAR" y, luego, en "Habilitar IP pública" o "Conectividad de IP pública" (no la saliente) y, para fines de desarrollo, ingresa "0.0.0.0/0" en "Redes externas autorizadas", pero, una vez que termines, quita y deshabilita la conectividad de IP pública.

4. Felicitaciones

¡Ya está todo listo!

Comienza a configurar tus datos con AlloyDB de forma rápida y sencilla.