Inicio rápido: Uso de comando az postgres up para crear una instancia de Azure Database for PostgreSQL con servidor único
Se aplica a:
Azure Database for PostgreSQL: servidor único
Importante
El servicio de servidor único de Azure Database for PostgreSQL está en proceso de retirada. Se recomienda encarecidamente actualizar a Azure Database for PostgreSQL: servidor flexible. Para obtener más información sobre la migración a Azure Database for PostgreSQL: servidor flexible, consulte ¿Qué sucede con el servidor único de Azure Database for PostgreSQL?.
Azure Database for PostgreSQL es un servicio administrado que le permite ejecutar, administrar y escalar bases de datos de PostgreSQL de alta disponibilidad en la nube. La CLI de Azure se usa para crear y administrar recursos de Azure desde la línea de comandos o en scripts. En este inicio rápido se muestra cómo usar el comando az postgres up para crear un servidor Azure Database for PostgreSQL mediante la CLI de Azure. Además de crear el servidor, el comando az postgres up crea una base de datos de ejemplo, un usuario raíz en la base de datos, abre el firewall para servicios de Azure y crea reglas de firewall predeterminadas para el equipo cliente. Estos valores predeterminados ayudan a acelerar el proceso de desarrollo.
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Creación de un servidor de Azure Database for PostgreSQL
Requisitos previos
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
Inicio de Azure Cloud Shell
Azure Cloud Shell es un shell interactivo gratuito que puede usar para ejecutar los pasos de este artículo. Tiene las herramientas comunes de Azure preinstaladas y configuradas para usarlas en la cuenta.
Para abrir Cloud Shell, seleccione Pruébelo en la esquina superior derecha de un bloque de código. También puede ir a https://shell.azure.com para iniciar Cloud Shell en una pestaña independiente del explorador.
Cuando se abra Cloud Shell, compruebe que Bash está seleccionado para el entorno. En las sesiones siguientes se usará la CLI de Azure en un entorno de Bash, seleccione Copiar para copiar los bloques de código, péguelos en Cloud Shell y, luego, presione Entrar para ejecutarlos.
Inicio de sesión en Azure
Cloud Shell se autentica de forma automática en la cuenta inicial con la que ha iniciado sesión. Use el script siguiente para iniciar sesión con otra suscripción, y reemplace <Subscription ID> con el id. de la suscripción de Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Para más información, vea Establecimiento de la suscripción activa o Inicio de sesión de forma interactiva
Instale la extensión db-up. Si se devuelve un error, asegúrese de que ha instalado la versión más reciente de la CLI de Azure. Consulte Instalación de la CLI de Azure.
az extension add --name db-up
Cree un servidor Azure Database for PostgreSQL mediante los pasos siguientes:
az postgres up
El servidor se crea con los siguientes valores predeterminados (a menos que los invalide manualmente):
| Configuración | Valor predeterminado | Descripción |
|---|---|---|
| server-name | Generado por el sistema | Un nombre único que identifique al servidor de Azure Database for PostgreSQL. |
| resource-group | Generado por el sistema | Un nuevo grupo de recursos de Azure. |
| sku-name | GP_Gen5_2 | El nombre de la SKU. Sigue la convención {plan de tarifa}_{generación de procesos}_{núcleos virtuales} en forma abreviada. El valor predeterminado es un servidor de uso general Gen5 con 2 núcleos virtuales. Consulte nuestra página de precios para más información acerca de los niveles. |
| backup-retention | 7 | El tiempo durante el cual se conserva la copia de seguridad. La unidad es días. |
| geo-redundant-backup | Disabled | Si se deben habilitar las copias de seguridad con redundancia geográfica en este servidor o no. |
| ubicación | westus2 | La ubicación de Azure para el servidor. |
| ssl-enforcement | Disabled | Si TLS/SSL debe habilitarse o no en este servidor. |
| storage-size | 5120 | La capacidad de almacenamiento del servidor (la unidad es megabytes). |
| version | 10 | La versión principal de PostgreSQL. |
| admin-user | Generado por el sistema | El nombre de usuario del administrador. |
| admin-password | Generado por el sistema | La contraseña del usuario administrador. |
Nota
Para más información acerca del comando az postgres up y sus parámetros adicionales, consulte la documentación de la CLI de Azure.
Una vez que se crea el servidor, incluye la siguiente configuración:
- Se crea una regla de firewall denominada "devbox". La CLI de Azure intenta detectar la dirección IP de la máquina desde la que se ejecuta el comando
az postgres upy permite esa dirección IP. - "Permitir el acceso a servicios de Azure" está activado. Este valor configura el firewall del servidor para que acepte conexiones de todos los recursos de Azure, incluidos aquellos que no están en la suscripción.
- Se crea una base de datos vacía denominada "sampledb"
- Se crea un usuario denominado "root" con privilegios para "sampledb"
Nota
Azure Database for PostgreSQL se comunica a través del puerto 5432. Al conectarse desde una red corporativa, es posible que el firewall de la red no permita el tráfico saliente a través del puerto 5432. Indique al departamento de TI que abran el puerto 5432 para conectarse al servidor.
Obtención de la información de conexión
Una vez finalizado el comando az postgres up, se le presenta una lista de cadenas de conexión de lenguajes de programación conocidos. Estas cadenas de conexión están preconfiguradas con atributos específicos del servidor Azure Database for PostgreSQL recién creado.
Puede usar el comando az postgres show-connection-string para mostrar de nuevo estas cadenas de conexión.
Limpieza de recursos
Limpie todos los recursos que creó en el inicio rápido mediante el siguiente comando. Este comando elimina el servidor Azure Database for PostgreSQL y el grupo de recursos.
az postgres down --delete-group
Si solo quiere eliminar el servidor recién creado, puede ejecutar el comando az postgres down.
az postgres down