Install
aspire agent init누구에게 맞나
Aspire 분산 앱을 만들고 있으며 에이전트가 먼저 작업 공간을 식별한 뒤 Aspire CLI를 맞게 쓰길 원하는 사람에게 맞다. 공식 저장소는
https://github.com/microsoft/aspire-skills
Aspire Skills를 이런 작업용 plugin, skill pack, extension pack으로 적는다. 흔한 일을 전용 스킬로 라우팅하게 하고 임시로 dotnet, curl, Docker, shell을 짜지 않게 한다. 재료는 어떤 에이전트 제품을 써야 한다고 쓰지 않으므로 클라이언트 명단을 스스로 채우지 말 것.
먼저 식별, 오케스트레이션 보기, 진단에 맞고 처음부터 게시하는 용도는 아니다. 재료의 aspire-deployment는 Publishes, deploys, and tears down Aspire apps. 첫 시도에서 그 길을 가지 말 것.
3분 안에 첫 시도 끝내기
주 경로는 공식 Aspire CLI를 쓰고 프롬프트에서 agent guidance 연결을 고른다. 기존 작업 공간에는 아래를 쓴다:
aspire agent init
재료는 aspire new(앱을 새로 만들고 프롬프트에서 안내를 고름)와 aspire init(기존 저장소에 Aspire 골격을 더하고 프롬프트에서 안내를 고름)도 쓴다. 첫 시도는 aspire agent init를 우선한다. 그것이 Add, update, or reconfigure Aspire guidance in an existing workspace이기 때문이다. 전제: 이 기기는 이미 Aspire CLI를 실행할 수 있고, 현재 디렉터리는 고치는 것을 허용한 Aspire 작업 공간이다. 재료는 CLI 설치 패키지 이름이나 버전 번호를 쓰지 않는다.
부작용: 작업 공간에 안내 설정을 쓰거나 갱신한다. 실행 전 디렉터리를 확인한다. 실행 후 에이전트가 recognize Aspire workspaces하는지 본 다음 리소스를 시작할지 정한다. 이 단계에서 배포하거나 철거하지 말 것.
저위험 작업: 최상위 aspire 라우팅 스킬이 읽기 전용 확인만 하게 한다. 예를 들어 작업 공간이 식별되는지, CLI가 맞게 호출되는지. 실행 중인 앱을 만져야 하면 aspire-monitoring만으로 logs, traces, dashboard, telemetry 또는 diagnostics를 보고 aspire-deployment는 호출하지 말 것. 성공 신호는 에이전트가 이런 Aspire 작업을 임시 dotnet / curl / Docker / shell로 바꾸지 않는 것이다. CLI가 없으면 「이 기기에 Aspire CLI가 없다」에서 멈추고 다른 설치기로 첫 시도를 끝내지 말 것.
사용 사례
사례 1: 기존 작업 공간에 안내를 붙이거나 갱신한다. 대응은 aspire agent init와 recognize Aspire workspaces. 저장소는 이미 있고 에이전트가 Aspire 방식으로만 일하길 원하는 사람에게 맞다. 재료는 프롬프트 문안이나 어떤 파일이 생성됐는지 쓰지 않는다. 확인할 수 있는 것은 기존 작업 공간이 guidance를 갱신할 수 있다는 것이다. 사례 1을 이미 클라우드에 배포된 것으로 쓰지 말 것.
사례 2: 오케스트레이션 뒤에 모니터링 진단을 한다. 대응은 aspire-orchestration(Starts, stops, waits for, and manages Aspire resources)와 aspire-monitoring(Routes logs, traces, dashboard, telemetry, and diagnostics work). 리소스는 이미 떠 있고 로그만 또는 대시보드만 보고 싶은 사람에게 맞다. 재료는 대시보드 주소나 경보 규칙을 쓰지 않는다. 모니터링은 그 스킬을 통하고 임시 curl을 쓰지 말 것. 리소스 시작/중지에는 부작용이 있으니 환경이 허용하는지 먼저 확인한 뒤 실행한다.
사용 경계
aspire-init는 Creates a new Aspire project or adds an Aspire skeleton to an existing repo. aspireify는 aspire init 뒤에 Wires an AppHost. 이들은 저장소 구조를 바꾸므로 읽기 전용 검사로 취급하지 말 것. aspire-deployment는 철거를 포함하며 추가 확인이 필요하다. 재료는 따로 npx skills add microsoft/aspire-skills와 한 묶음의 /plugin 명령도 나온다. 그것들은 다른 입구다. 첫 시도에서 Aspire CLI와 한 주 경로로 섞지 말고, 어떤 클라이언트가 독점한다고 추론하지도 말 것.