Adicione uma verificação de prontidão /health
Informe aos orquestradores quando seu serviço estiver pronto para atender.
Adicione uma verificação de prontidão /health é uma aula grátis de MLOps Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MLOps Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MLOps Academy inclui 4 aulas no total.
Como é que o cluster sabe?
Orquestradores como o Kubernetes precisam de uma forma de perguntar ao seu serviço: está ativo e pronto para receber tráfego? Um endpoint de health responde a isso. 🩺
Atividade versus prontidão
Liveness pergunta se o processo está em execução. Readiness pergunta se ele já consegue realmente atender pedidos. São duas perguntas diferentes.
Uma rota de estado simples
A verificação mais simples é um GET /health que retorna ok. Se o processo consegue responder, está pelo menos ativo.
@app.get("/health")
def health():
return {"status": "ok"}A prontidão precisa do modelo
Para aprendizagem automática, estar ativo não é suficiente. Uma verificação real de readiness confirma que o modelo terminou de carregar antes de aceitar tráfego de previsões.
Verifique o modelo carregado
Inspecione app.state para verificar se o modelo está presente. Se ainda for None, o serviço ainda não está pronto.
ready = app.state.model is not NoneSinalize a falta de prontidão com 503
Quando o modelo não estiver carregado, retorne o estado 503 para que o orquestrador retenha o tráfego até o serviço estar pronto.
from fastapi import HTTPException
raise HTTPException(status_code=503)Junte tudo
Uma rota /ready verifica o modelo e retorna ready ou gera um erro 503. A verificação continua rápida e sem trabalho pesado.
@app.get("/ready")
def ready(req: Request):
if req.app.state.model is None:
raise HTTPException(503)
return {"ready": True}Ligue as sondas
No Kubernetes, aponte uma readinessProbe para /ready e uma livenessProbe para /health. A plataforma consulta-as periodicamente.
Mantenha as verificações leves
As sondas são executadas frequentemente, por isso uma verificação de estado deve ser barata. Nunca execute nela uma inferência real do modelo nem aceda a uma base de dados lenta.
Faça implementações sem interrupção
As verificações de prontidão permitem atualizações graduais: os novos pods só recebem tráfego quando estiverem ready, para que os utilizadores nunca encontrem uma instância parcialmente iniciada. 🚦
Por que é importante
Os endpoints de estado e prontidão tornam o seu serviço de modelos um bom cidadão em qualquer cluster, permitindo escalabilidade, reinícios e implementações seguros. ✅
Verificação rápida
O seu modelo ainda está a carregar e uma sonda de prontidão acede a /ready. O que deve retornar o endpoint?
Recapitulação
Separou liveness de readiness, retornou 503 até o modelo carregar e ligou as sondas para implementações seguras. O seu serviço está pronto para o cluster! 🙌
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Adicione uma verificação de prontidão /health” é grátis?
Sim — o texto completo de “Adicione uma verificação de prontidão /health” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MLOps Academy, atualize para CoddyKit PRO. O curso de MLOps Academy inclui 4 aulas no total.
O que vou aprender em “Adicione uma verificação de prontidão /health”?
Informe aos orquestradores quando seu serviço estiver pronto para atender. Você pratica MLOps Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MLOps Academy?
Nenhuma experiência prévia é necessária. MLOps Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Adicione uma verificação de prontidão /health”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MLOps Academy?
Sim. Cada aula de MLOps Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Seu primeiro endpoint /predict
- Valide requisições com Pydantic
- Carregue o modelo uma única vez na inicialização
- Adicione uma verificação de prontidão /health