Entorno

El entorno es el rango 1. Un entorno corresponde a una implementación de Resource Manager.

CycleCloud ahora puede administrar implementaciones de Azure Resource Manager con plantillas de ARM. Estos entornos se pueden hacer referencia desde dentro de los objetos de plantilla cycleCloud.

Aunque el entorno es el rango 1, se requiere un objeto de clúster en el archivo de plantilla de clúster.

Ejemplo

[environment vnet]
  ManagedLifecycle=true
  TemplateURL = az://mystorageaccount/mycontainer/${ProjectVersion}/vnet.json
  ParameterValues.backendIpAddress1 = 10.0.1.4
  VariableOverrides.virtualNetworkName = azure-vnet

[environment appgateway]
  TemplateURL = https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-application-gateway-waf/azuredeploy.json
  ParameterValues.virtualNetworkName = ${vnet.Parameters.virtualNetworkName}

[environment existing]
  Azure.ResourceGroup = existingrg
  ManagedLifecycle = false

[cluster my-cluster]

$ es una referencia a un nombre de parámetro. ${} Es otra forma de hacer referencia a un nombre de parámetro y permite hacer referencia a un entorno.

En este ejemplo se iniciará la plantilla de ARM existente en az://mystorageaccount/mycontainer/${ProjectVersion}/vnet.json como implementación de ARM y se proporcionarán losrecursos y salidas como datos anidados dentro de la vnet variable.

Referencia de atributo

Atributo	Tipo	Definición
Credenciales	String	Nombre de la cuenta del proveedor de nube
Region	String	Ubicación de Azure, por ejemplo, westus2
TemplateURL	String	Dirección URL válida para la ubicación de la plantilla de ARM en la web. Use solo un atributo Template*.
TemplateContents	String	Lea en el json de plantilla como una cadena con @parametername referencia. Use solo un atributo Template*.
TemplatePath	String	Para su uso con Locker. Anexa la ruta de acceso a la caja de seguridad para la ubicación de la plantilla de arm. Use solo un atributo Template*.
Armario	String	Para su uso con TemplatePath. Admite la extracción de la plantilla de brazo de locker.
ParameterValues.	Parámetro de ARM	ParameterValues.my-parameter donde my-parameter es un parámetro. Los parámetros de las plantillas de ARM admiten cadenas, listas, enteros, booleanos.
VariableOverrides.	ARM Variable	VariableOverrides.my variable donde my-variable es un nombre de variable en la plantilla de ARM. Las variables de las plantillas de ARM admiten cadenas, listas, enteros, booleanos.
ParameterizeVariables	Boolean	Use con VariableValues. Exponga variables de plantilla de ARM en el menú de la interfaz de usuario del clúster y la plantilla de clúster.
VariableValues.	ARM Variable	VariableValues.my variable. Alternativa a VariableOverrides. Use con ParameterizeVariables.
Azure.ResourceGroup	String	Nombre del grupo de recursos de Azure para la implementación.
ManagedLifecycle	Boolean	Para su uso con la implementación existente. El valor predeterminado es true.
Nombre	String	Nombre del grupo de recursos que sale previamente.
Etiquetas.	String	Use tags.my-tag = my-tag-value para agregar etiquetas al grupo de recursos que posee la implementación, además de las etiquetas asignadas por CycleCloud de forma predeterminada.

En el caso de las implementaciones preexistentes, el nombre del objeto de entorno hace referencia al nombre de la implementación de ARM.

Uso de recursos y salidas de entorno

[environment vnet]
  ManagedLifecycle=true
  TemplateURL = az://mystorageaccount/mycontainer/${ProjectVersion}/vnet.json

[cluster my-cluster]
    [[node proxy]]
        IsReturnProxy = True
        SubnetId = ${vnet.resources.'azure-vnet/ProxySubnet'.id}

Después del modelo de implementación de ARM, los entornos crearán recursos y expondrán esos recursos a los demás objetos de plantilla de clúster para su uso.

Con la ${} notación, puede hacer referencia a los recursos de ARM creados en su esquema nativo.

Atributo	Definición
Salidas.	Use como ${environment-name.Outputs.my-output} en la plantilla donde my-output es el nombre de una salida en la plantilla de ARM.
Recursos.	Use como ${environment-name.Resources.my-resource-name.key1.key2} en la plantilla donde my-resource-name es el nombre de un recurso de la plantilla de ARM y key1, key2 son claves relacionadas en el objeto de recurso.

Referencia a recursos anidados

Los entornos administrados por CycleCloud se representan mediante una estructura de datos anidada. A menudo resulta útil hacer referencia a datos dentro de esta estructura.

[environment db]
TemplateContents = @raw-db-json
ParameterValues.DBName = @DBNameParameter

[cluster my-cluster]
  [[node my-node]]

     SubnetId = ${network.resources.'vnet/ComputeSubnet'.id}

     [[[configuration database]]]
        connection_string = ${db.Outputs.JDBCConnectionString}
        database_id = ${db.resources[ClusterName].id}

Los índices de variables anidadas pueden depender del tipo de recurso arm que se va a crear. env.resources.my-resource-name.id, env.resources['my-resource-name'].id, env.resources[MyResourceParam] son todos los formatos válidos para las referencias a variables anidadas.