AgentSkillsCN

start-solution

在后台模式下,使用 Aspire CLI 启动 BookStore 解决方案。通过此方法,可运行完整的应用栈(API、Web、PostgreSQL、Redis、Azurite)。

SKILL.md
--- frontmatter
name: start-solution
description: Start the BookStore solution using Aspire CLI in background mode. Use this to run the full application stack (API, Web, PostgreSQL, Redis, Azurite).

Follow this guide to start the BookStore solution using Aspire CLI.

Prerequisites Check

  1. Verify Environment (optional)
    • Run /doctor skill to ensure all tools are installed

Start the Solution

// turbo 2. Start Aspire in Background

bash
cd /home/avazalma/projects/BookStore && aspire run &
  • Starts: API, Web, PostgreSQL, Redis, Azurite, PgAdmin
  • Dashboard URL: http://localhost:15888 (check terminal output for actual port)
  • API URL: http://localhost:5000 (or assigned port)
  • Web URL: http://localhost:5001 (or assigned port)
  1. Verify Services Are Running
    • Check Aspire dashboard for green status on all resources
    • Console logs appear in terminal
    • Structured logs available via dashboard → Logs
    • Metrics available via dashboard → Metrics

Accessing Logs & Metrics

Aspire dashboard provides:

  • Console: Real-time stdout/stderr from all services
  • Structured Logs: Filterable logs with correlation IDs
  • Traces: Distributed tracing across services
  • Metrics: CPU, memory, HTTP request metrics

Stopping the Solution

// turbo 4. Stop Aspire (when done)

bash
# Find and kill the Aspire process
pkill -f "aspire run" || true

Related Skills

Prerequisites:

  • /doctor - Verify environment (Docker, .NET, Aspire CLI)

Next Steps:

  • /setup-aspire-mcp - Enable MCP access to logs/metrics
  • /run-integration-tests - Run tests against running instance

Debugging:

  • /debug-sse - If real-time updates not working
  • /debug-cache - If caching issues

See Also:

  • docs/guides/aspire-guide.md
  • src/BookStore.AppHost/AGENTS.md