aspire
Ajuda seu agente a gerenciar aplicativos distribuídos com Aspire. Ele pode criar, executar, depurar e implantar esses aplicativos.
O que ela faz
Aspire é um conjunto de ferramentas para criar e gerenciar aplicações distribuídas complexas. Ele ajuda a organizar diferentes partes da sua aplicação (como APIs, bancos de dados e interfaces de usuário) para que funcionem juntas, mesmo que sejam escritas em linguagens diferentes.
Quando usar
- ✓Quando você precisa criar uma nova aplicação distribuída.
- ✓Ao configurar ou conectar diferentes serviços em uma aplicação.
- ✓Para executar, depurar ou implantar aplicações complexas.
Exemplo do que pedir para a IA
“Como configuro o Aspire para usar um banco de dados PostgreSQL?”
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
O Aspire usa um arquivo central chamado 'AppHost' que funciona como um maestro. Ele define quais serviços existem, como eles se comunicam e quais recursos (como bancos de dados) eles precisam. O AppHost cuida de iniciar tudo na ordem certa e garantir que os serviços se encontrem.
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 github/awesome-copilot --skill aspireOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/aspire/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.
Aspire — Orquestração de Aplicações Distribuídas Poliglota
Aspire é um conjunto de ferramentas "code-first" e poliglota para construir aplicações distribuídas observáveis e prontas para produção. Ele orquestra contêineres, executáveis e recursos na nuvem a partir de um único projeto AppHost — independentemente de as cargas de trabalho serem C#, Python, JavaScript/TypeScript, Go, Java, Rust, Bun, Deno ou PowerShell.
Modelo mental: O AppHost é um maestro — ele não toca os instrumentos, mas diz a cada serviço quando iniciar, como se encontrar e monitora problemas.
O material de referência detalhado fica na pasta references/ — carregue sob demanda.
Referências
| Referência | Quando carregar |
|---|---|
| Referência da CLI | Flags de comando, opções ou uso detalhado |
| Servidor MCP | Configuração do MCP para assistentes de IA, ferramentas disponíveis |
| Catálogo de Integrações | Descoberta de integrações via ferramentas MCP, padrões de conexão |
| APIs Políglotas | Assinaturas de métodos, opções de encadeamento, padrões específicos de linguagem |
| Arquitetura | Internos do DCP, modelo de recursos, descoberta de serviços, rede, telemetria |
| Dashboard | Recursos do dashboard, modo autônomo, Visualizador GenAI |
| Implantação | Docker, Kubernetes, Azure Container Apps, App Service |
| Testes | Testes de integração contra o AppHost |
| Solução de Problemas | Códigos de diagnóstico, erros comuns e correções |
1. Pesquisando a Documentação do Aspire
A equipe do Aspire fornece um servidor MCP que oferece ferramentas de documentação diretamente dentro do seu assistente de IA. Veja Servidor MCP para detalhes de configuração.
Aspire CLI 13.2+ (recomendado — possui pesquisa de documentação integrada)
Se estiver executando o Aspire CLI 13.2 ou posterior (aspire --version), o servidor MCP inclui ferramentas de pesquisa de documentação:
| Ferramenta | Descrição |
|---|---|
list_docs |
Lista toda a documentação disponível em aspire.dev |
search_docs |
Realiza pesquisa lexical ponderada em toda a documentação indexada |
get_doc |
Recupera um documento específico pelo seu slug |
Essas ferramentas foram adicionadas no PR #14028. Para atualizar: aspire update --self --channel daily.
Para mais informações sobre essa abordagem, veja o post de David Pine: https://davidpine.dev/posts/aspire-docs-mcp-tools/
Aspire CLI 13.1 (apenas ferramentas de integração)
No 13.1, o servidor MCP fornece pesquisa de integração, mas não pesquisa de documentação:
| Ferramenta | Descrição |
|---|---|
list_integrations |
Lista as integrações de hospedagem Aspire disponíveis |
get_integration_docs |
Obtém documentação para um pacote de integração específico |
Para consultas gerais de documentação no 13.1, use o Context7 como sua fonte principal (veja abaixo).
Fallback: Context7
Use o Context7 (mcp_context7) quando as ferramentas de documentação do Aspire MCP não estiverem disponíveis (13.1) ou o servidor MCP não estiver em execução:
Etapa 1 — Resolver o ID da biblioteca (uma vez por sessão):
Chame mcp_context7_resolve-library-id com libraryName: ".NET Aspire".
| Classificação | ID da Biblioteca | Usar quando |
|---|---|---|
| 1 | /microsoft/aspire.dev |
Fonte primária. Guias, integrações, referência da CLI, implantação. |
| 2 | /dotnet/aspire |
Internos da API, detalhes de implementação em nível de código-fonte. |
| 3 | /communitytoolkit/aspire |
Integrações políglotas não-Microsoft (Go, Java, Node.js, Ollama). |
Etapa 2 — Consultar documentação:
libraryId: "/microsoft/aspire.dev", query: "Python integration AddPythonApp service discovery"
libraryId: "/communitytoolkit/aspire", query: "Golang Java Node.js community integrations"
Fallback: Pesquisa no GitHub (quando Context7 também não estiver disponível)
Pesquise o repositório oficial de documentação no GitHub:
- Repositório de Documentação:
microsoft/aspire.dev— caminho:src/frontend/src/content/docs/ - Repositório de Código-fonte:
dotnet/aspire - Repositório de Exemplos:
dotnet/aspire-samples - Integrações da Comunidade:
CommunityToolkit/Aspire
2. Pré-requisitos e Instalação
| Requisito | Detalhes |
|---|---|
| .NET SDK | 10.0+ (necessário mesmo para cargas de trabalho não-.NET — o AppHost é .NET) |
| Runtime de contêiner | Docker Desktop, Podman ou Rancher Desktop |
| IDE (opcional) | VS Code + C# Dev Kit, Visual Studio 2022, JetBrains Rider |
# Linux / macOS
curl -sSL https://aspire.dev/install.sh | bash
# Windows PowerShell
irm https://aspire.dev/install.ps1 | iex
# Verificar
aspire --version
…
Perguntas frequentes
O que é 'polyglot' no contexto do Aspire?
'Polyglot' significa que o Aspire suporta várias linguagens de programação. Você pode usar C#, Python, JavaScript, Go, Java e outras juntas na mesma aplicação.
Preciso saber programar em todas as linguagens suportadas?
Não. O Aspire gerencia a orquestração. Você só precisa saber programar nas linguagens que compõem os serviços que você está desenvolvendo.
O que é o AppHost?
O AppHost é o coração do Aspire. É um projeto que descreve sua aplicação distribuída, definindo os serviços, suas dependências e como eles devem ser executados. Pense nele como o maestro que coordena todos os músicos (serviços).
Detalhes
Descrição original do autor
Aspire skill covering the Aspire CLI, AppHost orchestration, service discovery, integrations, MCP server, VS Code extension, Dev Containers, GitHub Codespaces, templates, dashboard, and deployment. Use when the user asks to create, run, debug, configure, deploy, or troubleshoot an Aspire distributed application.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5009
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
bun-runtime
Faz seu agente usar o Bun para rodar, organizar e testar código. Ajuda a escolher o Bun em vez de outras ferramentas e a migrar projetos existentes.
affaan-m/ECC
database-migrations
Ajuda seu agente a fazer mudanças seguras em bancos de dados. Ele garante que as alterações possam ser desfeitas e minimiza o tempo de inatividade.
affaan-m/ECC
deployment-patterns
Configura fluxos de implantação e CI/CD, containerização e estratégias de rollback para garantir lançamentos seguros.
affaan-m/ECC