Provisionamento de Recursos na Nuvem

Provisionar recursos na nuvem significa criar e atualizar primitivas da AWS (ou de outra nuvem) de forma repetível e revisável. Equipes Python combinam ferramentas de IaC com boto3 para convergência, importações e tarefas operacionais que não pertencem a um template estático.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

import boto3
 
def provision_queue(sqs, name: str) -> str:
    try:
        resp = sqs.get_queue_url(QueueName=name)
        return resp["QueueUrl"]
    except sqs.exceptions.QueueDoesNotExist:
        resp = sqs.create_queue(
            QueueName=name,
            Attributes={"VisibilityTimeout": "60"},
        )
        return resp["QueueUrl"]

Quando usar isso:

• Bootstrap de contas antes da adoção completa de IaC
• Auxiliares idempotentes de garantia chamados de pipelines de deploy
• Fluxos de importação/adoção que envolvem APIs de nuvem
• Runbooks operacionais codificados como CLIs Python
• Emparelhamento com Pulumi/Terraform para recursos fora dos módulos atuais

Exemplo de Trabalho

Uma pequena CLI de provisionamento que garante anexos de políticas S3, SQS e IAM com logging estruturado.

"""provision.py - bootstrap idempotente de recursos AWS."""
from __future__ import annotations
 
import json
import logging
from dataclasses import dataclass
 
import boto3
from botocore.exceptions import ClientError
 
logging.basicConfig(level=logging.INFO, format="%(message)s")
log = logging.getLogger("provision")
 
@dataclass(frozen=True)
class ProvisionSpec:
    bucket: str
    queue: str
    tags: dict[str, str]
 
def ensure_bucket(s3, name: str, tags: dict[str, str]) -> str:
    buckets = {b["Name"] for b in s3.list_buckets().get("Buckets", [])}
    if name not in buckets:
        s3.create_bucket(Bucket=name)
        log.info(json.dumps({"action": "create", "resource": "s3", "name": name}))
    s3.put_bucket_tagging(Bucket=name, Tagging={"TagSet": [{"Key": k, "Value": v} for k, v in tags.items()]})
    return name
 
def ensure_queue(sqs, name: str) -> str:
    try:
        return sqs.get_queue_url(QueueName=name)["QueueUrl"]
    except ClientError as exc:
        if exc.response["Error"]["Code"] != "AWS.SimpleQueueService.NonExistentQueue":
            raise
    url = sqs.create_queue(QueueName=name)["QueueUrl"]
    log.info(json.dumps({"action": "create", "resource": "sqs", "name": name}))
    return url
 
def main() -> None:
    spec = ProvisionSpec(
        bucket="company-events-dev",
        queue="company-events-dev",
        tags={"Environment": "dev", "Owner": "platform"},
    )
    session = boto3.Session()
    s3 = session.client("s3")
    sqs = session.client("sqs")
    ensure_bucket(s3, spec.bucket, spec.tags)
    ensure_queue(sqs, spec.queue)
    log.info(json.dumps({"status": "ok", "bucket": spec.bucket, "queue": spec.queue}))
 
if __name__ == "__main__":
    main()

O que isso demonstra:

• get_queue_url + tratamento de exceção implementa a garantia idempotente de fila
• Marcação aplicada a cada execução para convergir metadados
• Logs estruturados em JSON adequados para artefatos de CI
• Sessão por execução respeita credenciais de perfil e função IAM AWS_PROFILE

Mergulho Profundo

Como Funciona

• Declare os recursos desejados em código, classes de dados ou programas IaC
• Planeje com ferramentas de pré-visualização (pulumi preview, terraform plan) ao usar IaC
• Aplique cria/atualiza; backends de estado rastreiam o que existe
• Verifique com APIs de descrição/obtenção e testes de integração
• Documente cada caminho de provisionamento no git com revisão de PR

Camadas de Provisionamento

Notas Python

from botocore.config import Config
 
retry_config = Config(retries={"max_attempts": 10, "mode": "standard"})
s3 = boto3.client("s3", config=retry_config)

Armadilhas

• Scripts apenas de criação - a segunda execução falha com BucketAlreadyExists. Correção: verifique a existência ou use IaC com estado.
• Sem tags nos recursos - alocação de custos e auditorias de políticas falham. Correção: conjunto de tags obrigatório validado na política de CI.
• Credenciais compartilhadas em laptops - provisionamento de máquinas de desenvolvimento com chaves de administrador. Correção: funções OIDC de CI com escopo por ambiente.
• Regiões codificadas - recursos pousam na partição/região errada. Correção: AWS_REGION ou configuração de sessão do spec do ambiente.
• Falha parcial silenciosa - fila criada, bucket falhou, script ainda sai com 0. Correção: agregue erros e códigos de saída diferentes de zero.

Alternativas

FAQs

Relacionados

• Noções Básicas de Automação de Infraestrutura - mentalidade idempotente
• Pulumi (IaC Python) - provisionamento declarativo
• Noções Básicas de boto3 - sessões e clientes
• S3 - operações de armazenamento de objetos
• SQS & SNS - primitivas de mensagens

Versões da Stack: Esta página foi escrita para Python 3.14.0 (estável 3.14, manutenção 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ e uv 0.6+.