Pular para o conteúdo principal

API Reference

Documentação de referência completa para os Custom Resource Definitions (CRDs) do Infra Operator.

Grupo de API​

Todos os recursos do Infra Operator usam o seguinte grupo de API:

Grupo de API:

aws-infra-operator.runner.codes/v1alpha1

Recursos Disponíveis​

Recursos Core​

KindDescriçãoStatus
AWSProviderCredenciais e configuração AWSEstável

Recursos de Rede​

KindDescriçãoStatus
VPCVirtual Private CloudEstável
SubnetSubnet da VPCEstável
InternetGatewayInternet GatewayEstável
NATGatewayNAT GatewayEstável
RouteTableRoute TableEstável
SecurityGroupSecurity GroupEstável
ElasticIPEndereço IP ElásticoEstável
ALBApplication Load BalancerEstável
NLBNetwork Load BalancerEstável

Recursos de Computação​

KindDescriçãoStatus
EC2InstanceInstância EC2Estável
EKSClusterCluster Kubernetes EKSEstável
ECSClusterCluster de Containers ECSEstável
LambdaFunctionFunção LambdaEstável
ComputeStackInfraestrutura All-in-OneEstável

Recursos de Storage​

KindDescriçãoStatus
S3BucketBucket S3Estável

Recursos de Banco de Dados​

KindDescriçãoStatus
RDSInstanceInstância de Banco de Dados RDSEstável
DynamoDBTableTabela DynamoDBEstável
ElastiCacheClusterCluster ElastiCacheEstável

Recursos de Containers​

KindDescriçãoStatus
ECRRepositoryContainer Registry ECREstável

Recursos de Mensageria​

KindDescriçãoStatus
SQSQueueFila SQSEstável
SNSTopicTópico SNSEstável

Recursos de Segurança​

KindDescriçãoStatus
IAMRoleRole IAMEstável
KMSKeyChave de Criptografia KMSEstável
SecretsManagerSecretSecret do Secrets ManagerEstável
CertificateCertificado ACMEstável
EC2KeyPairPar de Chaves SSH EC2Estável

Recursos de CDN & DNS​

KindDescriçãoStatus
CloudFrontDistribuição CloudFrontEstável
Route53HostedZoneZona Hospedada Route53Estável
Route53RecordSetRegistro DNS Route53Estável

Gerenciamento de API​

KindDescriçãoStatus
APIGatewayAPI GatewayEstável

Campos Comuns​

ProviderRef​

Todos os recursos AWS requerem uma referência a um AWSProvider:

Exemplo:

spec:
  providerRef:
    name: aws-production  # Nome do recurso AWSProvider

Tags​

A maioria dos recursos suporta tags AWS:

Exemplo:

spec:
  tags:
    Environment: production
    Team: platform
    ManagedBy: infra-operator

DeletionPolicy​

Controla o que acontece quando o recurso Kubernetes é deletado:

Exemplo:

spec:
  deletionPolicy: Delete  # Delete | Retain | Orphan
  • Delete: Deleta o recurso AWS quando o CR é deletado (padrão)
  • Retain: Mantém o recurso AWS mas remove do gerenciamento do operator
  • Orphan: Mantém o recurso AWS e remove metadados de ownership

Campos de Status​

Todos os recursos expõem campos de status comuns:

CampoTipoDescrição
readybooleanSe o recurso está pronto para uso
lastSyncTimestringÚltima sincronização bem-sucedida com AWS
conditionsarrayCondições de status detalhadas

Exemplo​

Exemplo:

apiVersion: aws-infra-operator.runner.codes/v1alpha1
kind: VPC
metadata:
  name: production-vpc
  namespace: infra-operator
spec:
  providerRef:
    name: aws-production
  cidrBlock: "10.0.0.0/16"
  enableDnsSupport: true
  enableDnsHostnames: true
  tags:
    Environment: production
  deletionPolicy: Retain
status:
  vpcID: vpc-0123456789abcdef0
  cidrBlock: "10.0.0.0/16"
  state: available
  ready: true
  lastSyncTime: "2025-11-22T20:18:08Z"

Próximos Passos​