ai-inference-service-mesh
Gerencia o tráfego de inteligência artificial de forma segura e confiável. Ajuda a garantir que os sistemas de IA funcionem sem interrupções.
O que ela faz
Este serviço ajuda a gerenciar e proteger o tráfego entre diferentes partes de um sistema de inteligência artificial (IA). Ele garante que a comunicação seja segura, confiável e que as atualizações de modelos possam ser feitas sem interrupções.
Quando usar
- ✓Ao lançar novas versões de modelos de IA.
- ✓Quando precisar garantir que apenas serviços autorizados se comuniquem.
- ✓Para otimizar o desempenho de sistemas de IA complexos.
Exemplo do que pedir para a IA
“Como posso configurar o sistema para que apenas serviços autorizados se comuniquem com o modelo de IA?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele usa ferramentas como Istio ou Linkerd para criar uma camada de rede segura. Essa camada controla quem pode falar com quem e como o tráfego é distribuído, sem precisar mudar o código principal da sua IA.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill ai-inference-service-meshOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/ai-inference-service-mesh/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Malha de Serviço de Inferência de IA
Aplique controles de malha Istio/Linkerd para proteger e otimizar o tráfego de IA leste-oeste entre microsserviços de inferência.
Por que usar Malha para IA
- Aplique mTLS entre gateway, retriever, reranker e serviços de modelo
- Aplique políticas de tráfego granulares sem alterações no código do aplicativo
- Execute entrega progressiva para backends de serviço de modelo
- Observe saltos de latência para cadeias de recuperação + geração
- Roteie requisições de inferência por versão do modelo, tenant ou nível de prioridade
- Proteja serviços caros com suporte a GPU contra falhas em cascata
Pré-requisitos
Confirme o cluster/contexto exato, versão da malha, esquemas de CRD, namespace de propriedade e escopo de mutação autorizado. Exemplos são fragmentos alternativos, não um manifesto para aplicar integralmente; múltiplas DestinationRules para o mesmo host devem ser consolidadas sob as regras de mesclagem da versão instalada. Visualize e valide em um ambiente descartável; proteja rotas de produção e evidências de rollback.
# Illustrative mutating install; default is not a validated production configuration
istioctl install --set profile=default \
--set meshConfig.accessLogFile=/dev/stdout \
--set meshConfig.defaultConfig.holdApplicationUntilProxyStarts=true
# Label inference namespace for sidecar injection
kubectl create namespace ai-inference
kubectl label namespace ai-inference istio-injection=enabled
# Verify installation
istioctl verify-install
istioctl analyze -n ai-inference
Padrões Principais
Modo Estrito de mTLS em Todo o Cluster
apiVersion: security.istio.io/v1beta1
kind: PeerAuthentication
metadata:
name: default
namespace: istio-system
spec:
mtls:
mode: STRICT
---
# Namespace-level override if needed for gradual rollout
apiVersion: security.istio.io/v1beta1
kind: PeerAuthentication
metadata:
name: ai-inference-mtls
namespace: ai-inference
spec:
mtls:
mode: STRICT
portLevelMtls:
# gRPC inference port
8081:
mode: STRICT
# Prometheus metrics port - allow plaintext scraping
9090:
mode: PERMISSIVE
AuthorizationPolicy Por Conta de Serviço
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
name: model-server-access
namespace: ai-inference
spec:
selector:
matchLabels:
app: model-server
action: ALLOW
rules:
- from:
- source:
principals:
- "cluster.local/ns/ai-inference/sa/api-gateway"
- "cluster.local/ns/ai-inference/sa/orchestrator"
to:
- operation:
methods: ["POST"]
paths: ["/v1/predict", "/v1/embeddings", "/v2/models/*/infer"]
---
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
name: deny-external-to-retriever
namespace: ai-inference
spec:
selector:
matchLabels:
app: vector-retriever
action: DENY
rules:
- from:
- source:
notNamespaces: ["ai-inference"]
Política de Saída para Endereços de Modelo Aprovados
apiVersion: networking.istio.io/v1alpha3
kind: ServiceEntry
metadata:
name: openai-api
namespace: ai-inference
spec:
hosts:
- api.openai.com
ports:
- number: 443
name: https
protocol: TLS
resolution: DNS
location: MESH_EXTERNAL
Um ServiceEntry registra um serviço; não é um firewall de saída completo. O Namespace AuthorizationPolicy controla requisições para workloads selecionados, não HTTPS de saída arbitrário por host de destino. Aplique saída aprovada através de um gateway/política de rede verificada e teste rotas de bypass. Para HTTPS originado pelo aplicativo, não origine também TLS em uma DestinationRule sem uma rota HTTP para TLS projetada (TLS duplo quebra a conexão).
Orientação oficial: Controle de saída do Istio.
Gerenciamento de Tráfego
VirtualService para Teste de Modelo A/B
apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
name: model-server
namespace: ai-inference
spec:
hosts:
- model-server
http:
# Roteia por cabeçalho para seleção explícita de versão do modelo
- match:
- headers:
x-model-version:
exact: "v2-experimental"
route:
- destination:
host: model-server
subset: v2-experimental
timeout: 120s
# Roteia por cabeçalho para coorte de teste A/B
- match:
- headers:
x-ab-cohort:
exact: "treatment"
route:
- destination:
host: model-server
subset: v2-experimental
weight: 100
timeout: 120s
…
Perguntas frequentes
O que é 'mTLS'?
É uma forma de garantir que a comunicação entre dois serviços seja segura, verificando a identidade de ambos (como um aperto de mão seguro).
O que significa 'canary release'?
É uma técnica para lançar novas versões de um serviço para um pequeno grupo de usuários antes de liberar para todos, minimizando riscos.
O que são 'políticas de tráfego'?
São regras que definem como o tráfego de rede deve se comportar, como quem pode acessar quais serviços e em que condições.
Detalhes
Descrição original do autor
Use verified service mesh patterns for AI inference traffic management, mTLS, canary releases, policy enforcement, and cross-cluster resilience.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2093
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC