Las constantes de Cloud Assembly permiten aplicar a los diseños pares clave-valor conocidos de forma silenciosa.

Cómo funcionan las constantes

La clave se muestra en el código de plantilla de nube, y el valor se convierte en parte de las implementaciones basadas en esa plantilla de nube. Las constantes requieren el enlace propgroup en el recurso.

El enlace propgroup solo se utiliza con grupos de propiedades constantes, no con grupos de propiedades de entrada.

Propiedades secretas

Si espera agregar una propiedad secreta a un grupo de propiedades, cree la propiedad secreta antes de continuar. Consulte Propiedades secretas de Cloud Assembly.

Creando el grupo de propiedades constante

  1. Vaya a Diseño > Grupos de propiedades y haga clic en Nuevo grupo de propiedades.
  2. Seleccione Valores constantes.
  3. Asigne un nombre y describa el nuevo grupo de propiedades.
    Nombre Los nombres de los grupos de propiedades deben ser únicos dentro de una organización determinada. Solo se permiten letras, números y guiones bajos.
    Nombre para mostrar Deje este campo en blanco. No se muestra ningún encabezado en el formulario de solicitud.
    Descripción Explique para qué sirve este conjunto de constantes.
    Ámbito

    Decida si un administrador puede compartir el grupo de propiedades con toda la organización. De lo contrario, solo un proyecto puede acceder al grupo de propiedades.

    Aunque siempre puede agregar o modificar propiedades del grupo, el ámbito es permanente y no se puede cambiar más adelante.

    Secretos: si espera agregar una propiedad secreta al grupo de propiedades, debe usar un ámbito de proyecto único. Las propiedades secretas se guardan solo en el nivel de proyecto.

    Proyecto Cuando el ámbito es solo de proyecto, este proyecto puede acceder al grupo de propiedades.
  4. Para agregar una propiedad constante al grupo, haga clic en Propiedad nueva.
  5. Introduzca un nombre que actúe como clave y una descripción.
  6. Seleccione un tipo de propiedad.
  7. Introduzca el valor de la constante que desee y haga clic en Crear.
    • Los tipos cadena, entero y número utilizan una entrada directa.
    • Para un valor de cadena secreta, seleccione una opción entre la lista de propiedades secretas del proyecto.
    • El tipo booleano utiliza un cuadro de selección para indicar el valor true.
    • Para el tipo de matriz u objeto, reemplace null por el valor que desee.
    Agregar una constante a un grupo de propiedades
  8. Agregue más constantes al grupo y, cuando haya terminado, haga clic en Guardar.
    Propiedades constantes agregadas a un grupo de propiedades

Enlazar recursos de plantilla de nube al grupo de propiedades

Para utilizar de forma silenciosa valores constantes dentro de un recurso, agregue enlaces propgroup en el recurso.

Puede agregar rápidamente un conjunto completo de constantes a un recurso si hace referencia al grupo de propiedades en sí.

resources:
  Cloud_Machine_1:
    type: Cloud.Machine
    properties:
      payerInfo: '${propgroup.payerDetails}'

Como alternativa, puede agregar constantes individuales del grupo de propiedades a determinadas partes del diseño.

resources:
  Cloud_Machine_1:
    type: Cloud.Machine
    properties:
      payerAccount: '${propgroup.payerDetails.payerAccountNumber}'
      payerCost: '${propgroup.payerDetails.payerCostCenter}'
      payerFed: '${propgroup.payerDetails.payerFederal}'