Gerador K8s Ingress
Kubernetes v1 Ingress e roteamento de tráfego nativo da nuvem

Gerador de YAML de Ingress do Kubernetes (Regras Nginx, Traefik e ALB)

Guia técnico para geração de manifestos Ingress no Kubernetes com terminação TLS, roteamento e anotações.

Privacidade 100% no cliente
networking.k8s.io/v1 ↔ cert-manager
Predefinições:
Configurações de controlador Ingress e protocolo global
Class: nginx•TLS Enabled
ACME / Vault
Regras e Configuração do Ingress
Regras de Roteamento e Mapeamento de Caminhos1 Host • 2 Caminhos
#1Nome do Host (FQDN):
Path:
Path:
spec.defaultBackend
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: production-web-ingress
  namespace: production
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
    nginx.ingress.kubernetes.io/ssl-redirect: true
    nginx.ingress.kubernetes.io/force-ssl-redirect: true
    nginx.ingress.kubernetes.io/proxy-body-size: 50m
    nginx.ingress.kubernetes.io/proxy-connect-timeout: 15
    nginx.ingress.kubernetes.io/proxy-read-timeout: 60
    nginx.ingress.kubernetes.io/enable-cors: true
    nginx.ingress.kubernetes.io/cors-allow-origin: "*"
spec:
  ingressClassName: nginx
  tls:
    - hosts:
        - api.example.com
      secretName: production-tls-secret
  rules:
    - host: api.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web-frontend-svc
                port:
                  number: 80
          - path: /api/v1
            pathType: Prefix
            backend:
              service:
                name: api-backend-svc
                port:
                  number: 8080
Regras de Roteamento
1 Host Regra • 2 Caminhos
Strict Host & Path Matching
Controlador & TLS
NGINX Ingress • TLS ativado
cert-manager (letsencrypt-prod)
Padrão de Especificação
networking.k8s.io/v1
Kubernetes 1.19+ • Helm & Kustomize Ready

Padrão de Especificação networking.k8s.io/v1

Aderência estrita aos padrões do Kubernetes v1 Ingress, substituindo extensions/v1beta1 descontinuado com validação robusta de pathType.

Geração Zero-Knowledge no Navegador

Todos os nomes de domínio, mapeamentos de serviços backend e segredos permanecem 100% locais no ambiente do seu navegador.

Compatível com Múltiplos Controladores

Modelos e anotações integradas para Ingress-Nginx, Traefik v3, AWS ALB Ingress Controller e certificados TLS cert-manager.

Referência técnica e guia de arquitetura

Referência do Desenvolvedor: K8S Ingress Generator — Guia de referência

Guia técnico para geração de manifestos Ingress no Kubernetes com terminação TLS, roteamento e anotações.

Parâmetros principais e controles

controller'nginx' | 'traefik' | 'alb' | 'gce' | 'haproxy' | 'custom'

Implementação do controlador Ingress de destino para determinar anotações e parâmetros específicos de roteamento.

Padrão: 'nginx'
ingressClassNamestring

Nome do recurso IngressClass em spec.ingressClassName para reconciliação no Kubernetes 1.18+.

Padrão: 'nginx'
pathType'Prefix' | 'Exact' | 'ImplementationSpecific'

Regra de correspondência de caminho sob a especificação networking.k8s.io/v1. Prefix valida elementos separados por barras.

Padrão: 'Prefix'
clusterIssuerstring

Identificador do recurso ClusterIssuer no cert-manager, injetado em cert-manager.io/cluster-issuer.

Padrão: 'letsencrypt-prod'
albScheme'internet-facing' | 'internal'

Esquema de provisionamento do AWS Load Balancer Controller via alb.ingress.kubernetes.io/scheme.

Padrão: 'internet-facing'

Dicas profissionais e melhores práticas

Migrar para ingressClassName

Substitua a anotação descontinuada kubernetes.io/ingress.class pelo campo spec.ingressClassName para compatibilidade estrita com Kubernetes 1.18+.

Validar correspondência Prefix

Ingress v1 utiliza a regra de maior prefixo coincidente; para reescritas com expressões regulares, configure pathType como ImplementationSpecific.

Isolar segredos TLS por namespace

Ao emitir certificados via cert-manager, confirme que os hosts em spec.tls correspondem às rotas e que a porta 80 está liberada para desafios HTTP-01.

Problemas comuns e solução de problemas

AWS ALB Controller retorna 502 Bad Gateway com target-type configurado como 'ip'

Certifique-se de que os Pods usam AWS VPC CNI com IPs roteáveis pela sub-rede do ALB ou mude target-type para 'instance' expondo o Service via NodePort.

Anotação rewrite-target do NGINX descarta segmentos de URL ou causa 404

Defina o pathType como ImplementationSpecific e configure a rota com expressões de captura como /api(/|$)(.*) em conjunto com rewrite-target: /$2.

Perguntas frequentes (FAQ)

Qual é a diferença entre os tipos de rota Prefix e ImplementationSpecific?▼

Prefix avalia segmentos de caminho separados por barras conforme RFC 3986 por maior correspondência. ImplementationSpecific transfere o processamento de sintaxe e regex para o controlador.

Como a integração com cert-manager configura o manifesto Ingress?▼

A integração insere cert-manager.io/cluster-issuer em metadata.annotations e popula spec.tls com secretName, disparando a emissão automática de certificados pelo ingress-shim.

Por que o AWS Load Balancer Controller não reconcilia o Ingress sem anotações?▼

O controlador ALB da AWS exige anotações explícitas de esquema e tipo de destino para instanciar TargetGroups e provisionar o Application Load Balancer na AWS.

O gerador armazena nomes de segredos ou topologia de cluster em servidores remotos?▼

Não. Todos os manifestos YAML, valores de Helm e comandos kubectl são processados localmente no navegador via JavaScript, sem envio de dados a servidores externos.

Ferramentas e utilitários relacionados

Todas as ferramentas →