Montaje de un volumen secreto en Azure Container Instances

Artículo
10/15/2024

Puede usar un volumen secreto para suministrar información confidencial en los contenedores de un grupo de contenedores. El volumen secreto almacena los secretos en los archivos del volumen, accesibles para los contenedores del grupo de contenedores. Mediante el almacenamiento de secretos en un volumen secreto, puede evitar agregar datos confidenciales, como claves SSH o credenciales de la base de datos, en el código de la aplicación.

Una vez implementado con secretos en un grupo de contenedores, un volumen secreto es solo lectura.
Tmpfs, un sistema de archivos respaldado por RAM, respalda todos los volúmenes secretos; su contenido nunca se escribe en almacenamiento no volátil.

Nota:

Los volúmenes secretos están restringidos actualmente a los contenedores Linux. Obtenga información sobre cómo pasar variables de entorno seguras para contenedores Windows y Linux en Establecimiento de variables de entorno. Aunque se está trabajando para incorporar todas las características a los contenedores Windows, puede consultar las diferencias actuales entre plataformas en la introducción.

Montaje de un volumen secreto: CLI de Azure

Para implementar un contenedor con uno o más secretos mediante la CLI de Azure, incluya los parámetros --secrets y --secrets-mount-path en el comando az container create. En este ejemplo se monta un volumen secreto que consta de dos archivos que contienen secretos, "mysecret1" y "mysecret2", en /mnt/secrets:

az container create \
    --resource-group myResourceGroup \
    --name secret-volume-demo \
    --image mcr.microsoft.com/azuredocs/aci-helloworld \
    --secrets mysecret1="My first secret FOO" mysecret2="My second secret BAR" \
    --secrets-mount-path /mnt/secrets

La siguiente salida de az container exec muestra la apertura de un shell en el contenedor en ejecución, que enumera los archivos incluidos en el volumen secreto y luego muestra su contenido:

az container exec \
  --resource-group myResourceGroup \
  --name secret-volume-demo --exec-command "/bin/sh"

/usr/src/app # ls /mnt/secrets
mysecret1
mysecret2
/usr/src/app # cat /mnt/secrets/mysecret1
My first secret FOO
/usr/src/app # cat /mnt/secrets/mysecret2
My second secret BAR
/usr/src/app # exit
Bye.

Montaje de un volumen secreto: YAML

También puede implementar grupos de contenedores con la CLI de Azure y una plantilla YAML. La implementación mediante la plantilla YAML es el método preferido al implementar grupos de contenedores que constan de varios contenedores.

Cuando se implementa con una plantilla YAML, los valores secretos deben estar codificados en Base64 en la plantilla. Aunque los valores del secreto aparecen en texto sin formato dentro de los archivos en el contenedor.

La siguiente plantilla YAML define un grupo de contenedores con un solo contenedor que monta un volumen secreto en /mnt/secrets. El volumen secreto tiene dos archivos que contienen secretos, "mysecret1" y "mysecret2".

apiVersion: '2019-12-01'
location: eastus
name: secret-volume-demo
properties:
  containers:
  - name: aci-tutorial-app
    properties:
      environmentVariables: []
      image: mcr.microsoft.com/azuredocs/aci-helloworld:latest
      ports: []
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
      volumeMounts:
      - mountPath: /mnt/secrets
        name: secretvolume1
  osType: Linux
  restartPolicy: Always
  volumes:
  - name: secretvolume1
    secret:
      mysecret1: TXkgZmlyc3Qgc2VjcmV0IEZPTwo=
      mysecret2: TXkgc2Vjb25kIHNlY3JldCBCQVIK
tags: {}
type: Microsoft.ContainerInstance/containerGroups

Para implementar con la plantilla YAML, guarde el anterior código de YAML en un archivo denominado deploy-aci.yaml y luego ejecute el comando az container create con el parámetro --file:

# Deploy with YAML template
az container create \
  --resource-group myResourceGroup \
  --file deploy-aci.yaml

Montaje de un volumen secreto: Resource Manager

Además de la implementación de CLI y YAML, puede implementar un grupo de contenedores con la plantilla de Azure Resource Manager.

En primer lugar, rellene la matriz volumes en la sección properties del grupo de contenedores de la plantilla. Cuando se implementa con una plantilla de Resource Manager, los valores secretos deben estar codificados en Base64 en la plantilla. Aunque los valores del secreto aparecen en texto sin formato dentro de los archivos en el contenedor.

A continuación, para cada contenedor del grupo de contenedores en el que quiera montar el volumen secreto, rellene la matriz volumeMounts en la sección properties de la definición del contenedor.

La siguiente plantilla de Resource Manager define un grupo de contenedores con un solo contenedor que monta un volumen secreto en /mnt/secrets. El volumen secreto tiene dos secretos, "mysecret1" y "mysecret2".

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "container1name": "aci-tutorial-app",
    "container1image": "microsoft/aci-helloworld:latest"
  },
  "resources": [
    {
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2021-03-01",
      "name": "secret-volume-demo",
      "location": "[resourceGroup().location]",
      "properties": {
        "containers": [
          {
            "name": "[variables('container1name')]",
            "properties": {
              "image": "[variables('container1image')]",
              "resources": {
                "requests": {
                  "cpu": 1,
                  "memoryInGb": 1.5
                }
              },
              "ports": [
                {
                  "port": 80
                }
              ],
              "volumeMounts": [
                {
                  "name": "secretvolume1",
                  "mountPath": "/mnt/secrets"
                }
              ]
            }
          }
        ],
        "osType": "Linux",
        "ipAddress": {
          "type": "Public",
          "ports": [
            {
              "protocol": "tcp",
              "port": "80"
            }
          ]
        },
        "volumes": [
          {
            "name": "secretvolume1",
            "secret": {
              "mysecret1": "TXkgZmlyc3Qgc2VjcmV0IEZPTwo=",
              "mysecret2": "TXkgc2Vjb25kIHNlY3JldCBCQVIK"
            }
          }
        ]
      }
    }
  ]
}

Para implementar con la plantilla de Resource Manager, guarde el anterior código JSON en un archivo denominado deploy-aci.json y luego ejecute el comando az deployment group create con el parámetro --template-file:

# Deploy with Resource Manager template
az deployment group create \
  --resource-group myResourceGroup \
  --template-file deploy-aci.json

Pasos siguientes

Volúmenes

Aprenda a montar otros tipos de volúmenes en Azure Container Instances:

Variables de entorno seguras

Otro método para proporcionar información confidencial a los contenedores (incluidos los contenedores de Windows) es mediante variables de entorno seguras.

Compartir a través de