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
quotaopcional en MiB;0lo desactiva. - Squash:
none,root-anonymousoall-anonymousasigna 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_TOKENconfigurado - Un par de claves de Object Storage existente en
IONOS_S3_ACCESS_KEYyIONOS_S3_SECRET_KEY, yIONOS_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 outputmuestra 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:
-
Uso de ZONE_3 para un servidor
- Problema: Una variable compartida
zonefunciona para volúmenes, pero el plan o la aplicación del servidor falla conZONE_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).
- Problema: Una variable compartida
-
Envío de un token bearer a Object Storage
- Problema: Las operaciones de cubo fallan con un error de autenticación, aunque
IONOS_TOKENesté 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_KEYyIONOS_S3_SECRET_KEYpara el proveedor, yAWS_ACCESS_KEY_IDyAWS_SECRET_ACCESS_KEYpara los clientes S3.
- Problema: Las operaciones de cubo fallan con un error de autenticación, aunque
-
Nombre de cubo ya ocupado
- Problema:
terraform applyfalla enionoscloud_s3_bucketen 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.
- Problema:
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_typey elavailability_zonedel volumen son inmutables; los volúmenes pueden utilizarZONE_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-4yus-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: