Compartir a través de

Creación y acceso a un entorno mediante la CLI de Azure

  • Artículo

En esta guía se explica cómo crear y acceder a un entorno en un proyecto de entornos de implementación de Azure existente mediante la CLI de Azure.

Requisitos previos

Creación de un entorno

La creación de un entorno crea automáticamente los recursos necesarios y un grupo de recursos para almacenarlos. El nombre del grupo de recursos sigue el patrón {projectName}-{environmentName}. Puede ver el grupo de recursos en Azure Portal.

Complete los pasos siguientes en la CLI de Azure para crear un entorno y configurar recursos. Puede ver las salidas tal y como se definen en la plantilla específica de Azure Resource Manager (plantilla de ARM).

Nota:

Solo los usuarios que tengan el rol de usuario de Deployment Environments, el de administrador de proyectos de DevCenter o un rol integrado con los permisos adecuados para poder crear un entorno. Los usuarios que tienen el rol Lector de Deployment Environments pueden ver sus propios entornos y los entornos creados por otros usuarios.

  1. Inicie sesión en la CLI de Azure.

    az login

  2. Instale la extensión del Centro de desarrollo de Azure para la CLI.

    az extension add --name devcenter --upgrade

  3. Enumere todos los proyectos de Azure Deployment Environments a los que tiene acceso:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table

  4. Configure la suscripción predeterminada como la suscripción que contiene el proyecto:

    az account set --subscription <subscriptionName>

  5. Configure el grupo de recursos predeterminado como el grupo de recursos que contiene el proyecto:

    az config set defaults.group=<resourceGroupName>

  6. Enumere el tipo de entornos que puede crear en un proyecto específico:

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table

  7. Enumere las definiciones de entorno que están disponibles para un proyecto específico:

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table

  8. Cree un entorno mediante una definición de entorno (una infraestructura como plantilla de código definida en el archivo environment.yaml) de la lista de definiciones de entorno disponibles:

    az devcenter dev environment create --dev-center-name <devcenterName>
    --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
    --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>

    Si la definición de entorno específica requiere parámetros, use --parameters y proporcione los parámetros como una cadena JSON o un archivo JSON. Por ejemplo:

    $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
az devcenter dev environment create --dev-center-name <devcenterName>
    --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
    --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
    --parameters $params

Nota

Puede usar --help para ver más detalles sobre cualquier comando, argumentos aceptados y ejemplos. Por ejemplo, use az devcenter dev environment create --help para ver más detalles sobre la creación de un entorno.

Solución de problemas de errores de permisos

Debe tener el rol de usuario de Deployment Environments, el de administrador de proyectos de DevCenter o un rol integrado con los permisos adecuados para poder crear un entorno.

Si no tiene los permisos correctos, no se crea el entorno. Puede aparecer un mensaje de error como el ejemplo siguiente:

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

Para resolver el problema, asigne los permisos correctos: Proporcionar acceso al equipo de desarrollo.

Acceso a un entorno

Para acceder a un entorno:

  1. Enumere los entornos existentes que están disponibles en un proyecto específico:

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>

  2. Vea los puntos de conexión de acceso a varios recursos, tal como se han definido en las salidas de la plantilla de ARM.

  3. Acceda a los recursos específicos mediante los puntos de conexión.

Implementación de un entorno

az devcenter dev environment deploy-action --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

Eliminación de un entorno

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

Contenido relacionado