Uso de la CLI para desarrolladores de Azure en nubes soberanas

En esta guía se explica cómo configurar la CLI para desarrolladores de Azure para aprovisionar recursos e implementar aplicaciones en nubes diferentes.

La CLI para desarrolladores de Azure admite las nubes siguientes:

• Valor predeterminado de Azure Public (AzureCloud)
• Azure operado por 21Vianet Cloud (AzureChinaCloud)
• Azure US Government (AzureUSGovernment)

La nube pública de Azure es la predeterminada y se usa si no se especifica ninguna nube.

Autenticación

Al cambiar entre nubes, ejecute azd auth login para autenticarse con la nube establecida.

En el ejemplo siguiente se establece una nube soberana y se ejecuta azd auth login para autenticarse con esa nube:

azd config set cloud.name AzureUSGovernment
azd auth login

Configuraciones en la nube

Las nubes se pueden configurar en el nivel de usuario, proyecto o entorno. El orden de prioridad de configuración es:

1. La configuración del entorno se selecciona primero
2. Si no hay ninguna nube configurada en el entorno, se usa la configuración del proyecto (azure.yaml)
3. Si no hay ninguna nube establecida en la configuración del proyecto, se usa la configuración de usuario (azd config set)
4. Si no hay ninguna nube establecida en la configuración de usuario, azd usa el público. AzureCloud

Configurar nubes con ajustes de usuario (azd config set)

Establecimiento de la nube para todas las azd operaciones mediante azd config

azd config set cloud.name AzureCloud

azd config set cloud.name AzureChinaCloud

azd config set cloud.name AzureUSGovernment

Configuración de nubes en el archivo azure.yaml del proyecto

Use el cloud objeto para establecer el nombre de la nube en el archivo azure.yaml del proyecto.

name: project-name
cloud:
  name: AzureCloud

name: project-name
cloud:
  name: AzureChinaCloud

name: project-name
cloud:
  name: AzureUSGovernment

Configuración de nubes en el archivo config.json de un entorno

Configure la nube para entornos específicos mediante la actualización del archivo de configuración del entorno en .azure/<environment-name>/config.json. Esto permite, por ejemplo, la implementación en nubes diferentes para distintos entornos.

{
    "cloud": {
        "name": "AzureCloud"
    }
}

{
    "cloud": {
        "name": "AzureChinaCloud"
    }
}

{
    "cloud": {
        "name": "AzureUSGovernment"
    }
}

Comandos y plataformas admitidos

Los comandos admitidos incluyen

• auth
• configuración
• desplegar
• bajar
• Entorno
• Provisión
• hacia arriba
• monitor
• show

azd pipeline no se admite en nubes soberanas.

devcenter No se admite la plataforma en nubes soberanas.

Implementación con Terraform

Al implementar en una nube soberana mediante azd y Terraform, la az CLI también debe configurarse para usar la nube deseada. Consulte la documentación Autenticación mediante la CLI de Azure de Terraform.

Establezca la variable ARM_ENVIRONMENT de entorno en el entorno deseado. Los valores habituales son:

• public (valor predeterminado)
• usgovernment
• china

Seleccione la nube adecuada mediante la az CLI:

az cloud set --name AzureCloud

az cloud set --name AzureChinaCloud

az cloud set --name AzureUSGovernment