Gerador de Manifestos Kubernetes

Orientação passo a passo para criar manifestos Kubernetes prontos para produção, incluindo Deployments, Services, ConfigMaps, Secrets e PersistentVolumeClaims.

Propósito

Esta habilidade fornece orientação abrangente para gerar manifestos Kubernetes bem estruturados, seguros e prontos para produção, seguindo as melhores práticas nativas da nuvem e as convenções do Kubernetes.

Quando Usar Esta Habilidade

Use esta habilidade quando precisar:

• Criar novos manifestos de Deployment do Kubernetes
• Definir recursos de Service para conectividade de rede
• Gerar recursos ConfigMap e Secret para gerenciamento de configuração
• Criar manifestos PersistentVolumeClaim para cargas de trabalho com estado
• Seguir as melhores práticas e convenções de nomenclatura do Kubernetes
• Implementar limites de recursos, verificações de saúde e contextos de segurança
• Projetar manifestos para implantações multi-ambiente

Padrões Detalhados e Exemplos Trabalhados

A documentação detalhada dos padrões está em references/details.md. Leia este arquivo quando o nível de navegação acima for insuficiente.

Resumo das Melhores Práticas

1. Sempre defina requisições e limites de recursos - Evita a escassez de recursos
2. Implemente verificações de saúde - Garante que o Kubernetes possa gerenciar sua aplicação
3. Use tags de imagem específicas - Evita implantações imprevisíveis
4. Aplique contextos de segurança - Execute como não root, remova capacidades
5. Use ConfigMaps e Secrets - Separe a configuração do código
6. Rotule tudo - Permite filtragem e organização
7. Siga convenções de nomenclatura - Use rótulos padrão do Kubernetes
8. Valide antes de aplicar - Use ferramentas de dry-run e validação
9. Versionar seus manifestos - Mantenha no Git com controle de versão
10. Documente com anotações - Adicione contexto para outros desenvolvedores

Solução de Problemas

Pods não iniciando:

• Verifique erros de pull de imagem: kubectl describe pod <pod-name>
• Verifique a disponibilidade de recursos: kubectl get nodes
• Verifique eventos: kubectl get events --sort-by='.lastTimestamp'

Service não acessível:

• Verifique se o seletor corresponde aos rótulos do pod: kubectl get endpoints <service-name>
• Verifique a configuração do tipo e porta do service
• Teste de dentro do cluster: kubectl run debug --rm -it --image=busybox -- sh

ConfigMap/Secret não carregando:

• Verifique se os nomes correspondem no Deployment
• Verifique o namespace
• Garanta que os recursos existam: kubectl get configmap,secret

Próximos Passos

Após criar os manifestos:

1. Armazene em um repositório Git
2. Configure um pipeline de CI/CD para implantação
3. Considere usar Helm ou Kustomize para templating
4. Implemente GitOps com ArgoCD ou Flux
5. Adicione monitoramento e observabilidade

Habilidades Relacionadas

• helm-chart-scaffolding - Para templating e empacotamento
• gitops-workflow - Para implantações automatizadas
• k8s-security-policies - Para configurações avançadas de segurança