14 min de lectura

Objetivos de aprendizaje

Al final de este módulo, podrás:

  • Aprovisionar y adjuntar volúmenes de Block Storage con `ionoscloud_volume`, seleccionando correctamente `disk_type` y `availability_zone`
  • Crear cubos de IONOS Cloud Object Storage con `ionoscloud_s3_bucket` y generar credenciales de Access Key y Secret Key en Terraform
  • Exponer las credenciales de almacenamiento desde Terraform como salidas sensibles para la configuración de aplicaciones
  • Aprovisionar almacenamiento de archivos compartido con `ionoscloud_nfs_cluster` y `ionoscloud_nfs_share`
  • Seleccionar Block Storage, Object Storage o Network File Storage en el código según el patrón de acceso

Unidad 2.4: Aprovisionamiento de almacenamiento como código

Introducción

TaskBoard ahora cuenta con cómputo, una red segmentada y un equilibrador de carga. Todavía almacena todo en el disco del sistema del servidor de la API, y los usuarios aún no pueden cargar archivos adjuntos. Necesita un volumen de datos que sobreviva a la reconstrucción del servidor, un cubo para los archivos cargados y credenciales que su aplicación pueda leer desde las salidas de Terraform.

En esta unidad, aprovisiona la capa de almacenamiento como código. Agrega un volumen de datos de Block Storage con la clase de rendimiento y la zona adecuadas, crea un cubo de IONOS Cloud Object Storage con su propia clave de acceso, conecta el patrón de estado remoto de la Unidad 1.2 y observa cómo Network File Storage (NFS) sigue el mismo patrón para los archivos compartidos. En el Code Lab, implementa la capa de almacenamiento de TaskBoard y verifica el cubo con un cliente S3.

1. Block Storage con ionoscloud_volume

resource "ionoscloud_volume" "api_data" {
  datacenter_id     = ionoscloud_datacenter.taskboard.id
  server_id         = ionoscloud_server.api.id
  name              = "taskboard-api-data"
  size              = 100
  disk_type         = "PERFORMANCE"
  availability_zone = "ZONE_1"
  licence_type      = "UNKNOWN"
  bus               = "VIRTIO"
}

El volumen de datos es independiente del volumen de sistema en línea del servidor, por lo que puede reconstruir el servidor sin perder datos. Se requiere licence_type (o image_name); para un volumen de datos secundario, la documentación del proveedor solicita UNKNOWN. server_id adjunta el volumen; déjelo sin establecer para un volumen sin adjuntar.

1.1 Selección de la clase Performance

disk_type toma ESSENTIAL, BALANCED o PERFORMANCE para las clases de rendimiento de Block Storage, y es inmutable. Essential es una clase de bajo costo para datos como copias de seguridad y archivos, Balanced es una clase de uso general para servidores web y entornos de desarrollo, y Performance es una clase de alto rendimiento para datos que requieren baja latencia, como bases de datos. La siguiente tabla muestra los límites por clase:

Volumen de almacenamiento Essential Balanced Performance
Tamaño mínimo por volumen 1 GB 1 GB 1 GB
Tamaño máximo por volumen 4 TB 4 TB 4 TB
Velocidad máxima de lectura/escritura, secuencial 200 MB/s (estático por instancia) 300 MB/s por volumen con tamaño de bloque de 1 MB 600 MB/s por volumen con tamaño de bloque de 1 MB
Velocidad máxima de lectura, aleatoria completa 1.100 (estático por instancia) 24.000 IOPS con tamaño de bloque de 4 KB y mínimo 2 núcleos, 2 GB de RAM por volumen 45.000 IOPS con tamaño de bloque de 4 KB y mínimo 4 núcleos, 4 GB de RAM por volumen
Velocidad máxima de escritura, aleatoria completa 1.100 (estático por instancia) 18.000 IOPS con tamaño de bloque de 4 KB y mínimo 2 núcleos, 2 GB de RAM por volumen 30.000 IOPS con tamaño de bloque de 4 KB y mínimo 4 núcleos, 4 GB de RAM por volumen

Como se muestra arriba, el rendimiento de Essential es estático, mientras que Balanced y Performance escalan con el tamaño del volumen: Performance ofrece 75 IOPS por GB para lecturas aleatorias completas con tamaño de bloque de 4 KB. IONOS CLOUD recomienda al menos 100 GB para obtener el beneficio completo de las clases SSD, y los volúmenes mayores de 600 GB alcanzan los valores máximos. El servidor de API de TaskBoard tiene 4 núcleos y 8 GB de RAM, por lo que un volumen Performance de 100 GB se adapta a su carga de trabajo similar a una base de datos.

1.2 La restricción de la zona de disponibilidad

resource "ionoscloud_server" "api" {
  # ...
  availability_zone = "ZONE_1"   # servers: AUTO, ZONE_1, ZONE_2
}

resource "ionoscloud_volume" "api_data" {
  # ...
  availability_zone = "ZONE_1"   # volumes: AUTO, ZONE_1, ZONE_2, ZONE_3
}

Block Storage ofrece Zone 1, Zone 2, Zone 3 y Auto. Compute solo ofrece Zone 1, Zone 2 y Auto, por lo que una variable compartida por servidores y volúmenes no debe permitir ZONE_3:

variable "server_zone" {
  type    = string
  default = "ZONE_1"
  validation {
    condition     = contains(["AUTO", "ZONE_1", "ZONE_2"], var.server_zone)
    error_message = "Servers support AUTO, ZONE_1 or ZONE_2 only."
  }
}

La zona del volumen es inmutable. Para mover un volumen a otra zona, cree una instantánea (Unidad 2.1) y aprovisione un nuevo volumen a partir de ella.

1.3 Redimensionamiento

Puede aumentar size en el código después del aprovisionamiento, incluso mientras el servidor está en ejecución, si el sistema operativo lo permite. No es posible reducir el tamaño. Después de un aumento, extienda la partición y el sistema de archivos dentro del invitado.

2. IONOS Cloud Object Storage como código

IONOS Cloud Object Storage es compatible con el protocolo S3 y se autentica mediante un par de claves: una Access Key y una Secret Key. No utiliza el bearer token de la Cloud API. Object Storage no está habilitado de forma predeterminada; el propietario del contrato o un administrador lo habilita.

2.1 Credenciales del proveedor y el bucket

El proveedor gestiona los buckets con un par de claves existente, que usted transmite a través del entorno (Unidad 1.2):

export IONOS_S3_ACCESS_KEY="<access key>"
export IONOS_S3_SECRET_KEY="<secret key>"
export IONOS_S3_REGION="eu-central-3"
resource "ionoscloud_s3_bucket" "uploads" {
  name          = "taskboard-uploads-dev-7f3a"
  region        = "eu-central-3"
  force_destroy = false
  tags = {
    app = "taskboard"
    env = "dev"
  }
}

El nombre del bucket debe ser único en todas las cuentas de IONOS en todas las regiones de Object Storage y debe tener de 3 a 63 caracteres, por lo que debe agregar un sufijo aleatorio o de entorno. El region debe coincidir con la región global (IONOS_S3_REGION o el atributo de proveedor s3_region) o la región global debe estar sin definir. Los buckets propiedad del contrato están disponibles en eu-central-3, eu-central-4 y us-central-1; su endpoint sigue el patrón s3.<region>.ionoscloud.com.

Con force_destroy = false, Terraform se niega a eliminar un bucket que aún contiene objetos. Establezca este valor en true solo para entornos efímeros, ya que elimina de forma irreversible todo el contenido.

2.2 Credenciales de la aplicación

TaskBoard no debe utilizar su clave personal. Cree una clave dedicada en Terraform y expóngala como salidas sensibles:

resource "ionoscloud_object_storage_accesskey" "taskboard" {
  description = "taskboard-api uploads"
}

output "uploads_access_key" {
  value     = ionoscloud_object_storage_accesskey.taskboard.accesskey
  sensitive = true
}

output "uploads_secret_key" {
  value     = ionoscloud_object_storage_accesskey.taskboard.secretkey
  sensitive = true
}

El atributo accesskey es una cadena de 92 caracteres. Un usuario puede tener hasta 5 claves de acceso, por lo que debe limpiar las claves de los entornos destruidos. Para crear una clave para un usuario de IONOS CLOUD separado, utilice ionoscloud_s3_key con el user_id de dicho usuario; su atributo calculado secret_key también debe incluirse en una salida sensible.

sensitive = true oculta los valores en la salida de plan y apply, pero estos siguen almacenándose en texto plano en el estado. Esta es una razón más para utilizar el estado remoto con control de acceso descrito a continuación.

2.3 El bucket como backend de Terraform

La Unidad 1.2 configuró el backend s3 contra un endpoint de IONOS Cloud Object Storage. Cree el bucket de estado una sola vez, fuera de la configuración que almacena, por ejemplo, en un pequeño proyecto de inicialización:

resource "ionoscloud_s3_bucket" "tfstate" {
  name   = "taskboard-tfstate-7f3a"
  region = "eu-central-3"
}

resource "ionoscloud_s3_bucket_versioning" "tfstate" {
  bucket = ionoscloud_s3_bucket.tfstate.name
  versioning_configuration {
    status = "Enabled"
  }
}

El versionado le permite recuperar un archivo de estado anterior tras una aplicación incorrecta. El bloque de backend en sí permanece como se muestra en la Unidad 1.2 y se autentica con AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY.

3. Network File Storage

NFS es una referencia del mismo patrón para TaskBoard: se utiliza solo si varios servidores deben compartir archivos. Es un servicio de almacenamiento compartido administrado al que las VM acceden a través de una LAN privada mediante NFSv4.2.

resource "ionoscloud_nfs_cluster" "shared" {
  name      = "taskboard-shared"
  location  = "de/txl"
  size      = 2048
  size_unit = "GiB"

  nfs {
    min_version = "4.2"
  }

  connections {
    datacenter_id = ionoscloud_datacenter.taskboard.id
    lan           = ionoscloud_lan.app.id
    ip_address    = "10.10.1.8/24"
  }
}

resource "ionoscloud_nfs_share" "attachments" {
  location   = "de/txl"
  cluster_id = ionoscloud_nfs_cluster.shared.id
  name       = "attachments"
  quota      = 102400
  uid        = 1000
  gid        = 1000

  client_groups {
    description = "app tier"
    ip_networks = ["10.10.1.0/24"]
    hosts       = ["10.10.1.11"]
    nfs {
      squash = "root-anonymous"
    }
  }
}

Diferencias clave con respecto a Block Storage:

  • Tamaño: el clúster varía de 2 TiB a 42 TiB en incrementos de 1 TiB, y solo puede aumentarse, no reducirse.
  • Compartidos: cada compartido tiene un quota opcional en MiB; 0 lo desactiva.
  • Squash: none, root-anonymous o all-anonymous asigna los usuarios del cliente al ID anónimo.
  • Conexión: el clúster obtiene una dirección en su LAN privada; utilice una del rango de managed-services (Unidad 2.2).
  • Montaje: los clientes montan con mount -t nfs <cluster-ip>:<share-uuid> <local-mount-path>.

La API de NFS es regional (https://nfs.{region}.ionos.com), y NFS no está disponible en gb/bhx.

4. Elección del almacenamiento en código

Patrón de acceso Servicio Recurso de Terraform
Un servidor lee y escribe bloques (archivos de base de datos, datos de la aplicación) Block Storage ionoscloud_volume
Muchos clientes leen y escriben objetos a través de HTTP (subidas, recursos estáticos, copias de seguridad, estado de Terraform) IONOS Cloud Object Storage ionoscloud_s3_bucket
Varios servidores comparten un sistema de archivos POSIX en una LAN privada Network File Storage ionoscloud_nfs_cluster, ionoscloud_nfs_share

Como muestra la tabla, la pregunta decisiva es quién accede a los datos y a través de qué protocolo. TaskBoard utiliza Block Storage para el volumen de datos del servidor de API y Object Storage para las subidas de los usuarios. En la Unidad 2.5, los datos transaccionales se trasladan a un clúster administrado de PostgreSQL, por lo que el volumen de datos solo contiene archivos de trabajo locales.

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.eu-central-3.ionoscloud.com",
    aws_access_key_id=ACCESS_KEY,
    aws_secret_access_key=SECRET_KEY,
    region_name="eu-central-3",
)
s3.upload_file("report.pdf", "taskboard-uploads-dev-7f3a", "tasks/42/report.pdf")

El lado de la aplicación solo necesita el endpoint y el par de claves de las salidas de la sección 2.2. El módulo 4 aborda la integración en profundidad.

Tarjeta rápida de referencia de la API

Endpoints clave de la API detrás de los recursos de esta unidad:

Método Endpoint Descripción
POST /datacenters/{datacenterId}/volumes Creado por ionoscloud_volume (Cloud API)
POST /datacenters/{datacenterId}/servers/{serverId}/volumes Adjunta un volumen a un servidor (Cloud API)
PUT /{bucket} Crea un bucket (S3 API, https://s3.<region>.ionoscloud.com)
POST /clusters Creado por ionoscloud_nfs_cluster (NFS API, https://nfs.{region}.ionos.com)
POST /clusters/{clusterId}/shares Creado por ionoscloud_nfs_share (NFS API)

URL base: https://api.ionos.com/cloudapi/v6 (Object Storage y NFS utilizan sus propios endpoints, mostrados arriba) Autenticación: Authorization: Bearer <token> (Object Storage: Access Key y Secret Key)

Laboratorio de código

Objetivo: Desplegar la capa de almacenamiento de TaskBoard con Terraform: un volumen de datos de Block Storage adjunto al servidor de la API y un bucket de Object Storage con su propia clave de acceso, con las credenciales como salidas sensibles.

Requisitos previos:

  • El proyecto de las unidades 2.1 a 2.3 con IONOS_TOKEN configurado
  • Un par de claves de Object Storage existente en IONOS_S3_ACCESS_KEY y IONOS_S3_SECRET_KEY, y IONOS_S3_REGION=eu-central-3
  • La CLI de AWS instalada localmente

Paso 1: Agregar el volumen de datos

Agregue ionoscloud_volume.api_data de la sección 1. Establezca su availability_zone en AUTO, o en la zona que configuró en el servidor, y luego ejecute el plan:

terraform plan | grep "will be created"

Salida esperada:

  # ionoscloud_volume.api_data will be created

Paso 2: Agregar el bucket y la clave de acceso

Agregue ionoscloud_s3_bucket.uploads (con un sufijo único propio), ionoscloud_object_storage_accesskey.taskboard y ambas salidas de la sección 2.2. Luego aplique:

terraform apply -auto-approve | tail -n 5

Salida esperada:

Apply complete! Resources: 3 added, 0 changed, 0 destroyed.

Outputs:
uploads_access_key = <sensitive>
uploads_secret_key = <sensitive>

Paso 3: Montar el volumen en el servidor de API

ssh root@"$(terraform output -raw api_public_ip)" 'lsblk -o NAME,SIZE,TYPE,MOUNTPOINT'

Salida esperada:

NAME   SIZE TYPE MOUNTPOINT
vda     20G disk
└─vda1  20G part /
vdb    100G disk

Formatee y monte vdb (por ejemplo, con mkfs.ext4 y una entrada de /etc/fstab), o agregue esos pasos a la configuración cloud-config de un servidor reconstruido.

Paso 4: Configure la AWS CLI con la nueva clave

export AWS_ACCESS_KEY_ID="$(terraform output -raw uploads_access_key)"
export AWS_SECRET_ACCESS_KEY="$(terraform output -raw uploads_secret_key)"
aws s3 ls --endpoint-url https://s3.eu-central-3.ionoscloud.com --region eu-central-3

Salida esperada:

... taskboard-uploads-dev-7f3a

Paso 5: Cargar y volver a leer un objeto

echo "hello taskboard" > hello.txt
aws s3 cp hello.txt s3://taskboard-uploads-dev-7f3a/tests/hello.txt \
  --endpoint-url https://s3.eu-central-3.ionoscloud.com --region eu-central-3
aws s3 ls s3://taskboard-uploads-dev-7f3a/tests/ \
  --endpoint-url https://s3.eu-central-3.ionoscloud.com --region eu-central-3

Salida esperada:

upload: ./hello.txt to s3://taskboard-uploads-dev-7f3a/tests/hello.txt
... 16 hello.txt

Lista de verificación:

  • [ ] El volumen de datos está adjunto al servidor de API y es visible como un segundo disco
  • [ ] El bucket existe en eu-central-3
  • [ ] La nueva clave de acceso puede listar el bucket y cargar un objeto
  • [ ] terraform output muestra ambas credenciales como <sensitive>

Limpieza:

aws s3 rm s3://taskboard-uploads-dev-7f3a --recursive \
  --endpoint-url https://s3.eu-central-3.ionoscloud.com --region eu-central-3
terraform destroy -auto-approve

Errores comunes

Errores de desarrollo que debe evitar con el tema de esta unidad:

  1. Uso de ZONE_3 para un servidor

    • Problema: Una variable compartida zone funciona para volúmenes, pero el plan o la aplicación del servidor falla con ZONE_3.
    • Por qué ocurre: Block Storage tiene la Zona 3, pero Compute solo admite la Zona 1, la Zona 2 y Auto.
    • Solución: Mantenga variables separadas para las zonas del servidor y del volumen, y valide la zona del servidor (sección 1.2).
  2. Envío de un token bearer a Object Storage

    • Problema: Las operaciones de cubo fallan con un error de autenticación, aunque IONOS_TOKEN esté establecido.
    • Por qué ocurre: Object Storage se autentica con una Access Key y una Secret Key, no con tokens de Cloud API.
    • Solución: Establezca IONOS_S3_ACCESS_KEY y IONOS_S3_SECRET_KEY para el proveedor, y AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para los clientes S3.
  3. Nombre de cubo ya ocupado

    • Problema: terraform apply falla en ionoscloud_s3_bucket en un entorno nuevo.
    • Por qué ocurre: Los nombres de cubo deben ser únicos en todas las cuentas de IONOS y en todas las regiones de Object Storage.
    • Solución: Agregue un sufijo, por ejemplo desde random_id, y mantenga el nombre en una variable por entorno.

Resumen

Ahora puede aprovisionar la capa de almacenamiento de TaskBoard como código. Los volúmenes de Block Storage utilizan ESSENTIAL, BALANCED o PERFORMANCE, se adjuntan con server_id, crecen pero nunca se reducen, y residen en zonas que la computación no comparte por completo. Los cubos de IONOS Cloud Object Storage se autentican con pares de Access Key y Secret Key que Terraform puede crear y entregar a su aplicación como salidas sensibles, y un cubo versionado almacena su estado remoto. NFS añade almacenamiento POSIX compartido en una LAN privada con el mismo patrón de recursos.

Puntos clave:

  • disk_type y el availability_zone del volumen son inmutables; los volúmenes pueden utilizar ZONE_3, pero los servidores no
  • Balanced y Performance escalan con el tamaño; reserve al menos 100 GB para un rendimiento completo de SSD
  • La API S3 de Object Storage utiliza Access Key más Secret Key, no tokens de portador (solo la API de gestión de Object Storage para claves acepta un token de portador); los nombres de cubo son únicos a nivel global
  • Marque las salidas de credenciales como sensitive, y proteja el estado que aún las contiene
  • Los clústeres de NFS van desde 2 TiB hasta 42 TiB, crecen en pasos de 1 TiB y se adjuntan a una LAN privada

Terminología importante:

  • Clase Performance: El tipo de Block Storage establecido en disk_type: Essential, Balanced o Performance
  • Cubo propiedad del contrato: Un cubo propiedad del propietario del contrato, disponible en eu-central-3, eu-central-4 y us-central-1
  • Access Key y Secret Key: El par de claves que los clientes S3 y el proveedor utilizan para Object Storage
  • Salida sensible: Una salida de Terraform oculta de la salida de la CLI, pero que aún se almacena en el estado
  • Compartición: Un directorio exportado de un clúster NFS, con su propia cuota y grupos de clientes

Próximos pasos

Continuar aprendiendo: Unidad 2.5: Aprovisionamiento de base de datos y servicio de streaming

Temas relacionados: