Google agents-cli 제품군에 포함된 배포 스킬(SKILL.md에 Google 서명): 에이전트가 agents-cli를 사용하여 ADK 등 프레임워크로 작성된 에이전트를 Agent Runtime, Cloud Run 또는 GKE에 배포하고, 시크릿, 서비스 계정, CI/CD 파이프라인, 롤백 및 문제 해결을 구성하도록 안내합니다.
skills.sh 설치 횟수 525087(+4817 / 24시간)
보안 감사: 위험 경고 있음
- 서드파티 패키지(npx / pip 등)를 설치하거나 실행하며, 이는 명령어 실행에 해당합니다
- 에이전트가 셸 / 스크립트 명령어를 실행하도록 합니다
- 네트워크 요청을发起하거나 외부 API / 원격 MCP를 호출합니다
- 사용 데이터를 보고합니다(원격 측정)
- 환경 변수를 읽거나 API 키 / 토큰이 필요합니다
- 감사 범위: GitHub google/agents-cli/skills/google-agents-cli-deploy/SKILL.md(SKILL.md 텍스트만 스캔)
이유
- 먼저 세 가지 대상의 비교표(확장성, 네트워크, 세션 상태, 과금 방식, 사용 난이도)를 제시하고, 사용자가 어떤 것을 선택할지 묻도록 에이전트에 요구합니다. OAuth 사용자 승인이 필요한 에이전트는 Agent Runtime을 권장하며, 실시간 음성 처리는 Cloud Run에 --timeout 3600 및 --min-instances 1를 추가하는 것을 권장합니다
- 배포 전에 평가 점수와 테스트 결과를 사용자에게 보여주고 "dev 환경에 배포할 준비가 되셨나요?"라고 물어보며, 명확한 동의를 얻은 후에만 agents-cli deploy를 실행합니다. SKILL.md에는 인간 승인이 없으면 절대 배포하지 않는다고 명시되어 있습니다
- 시크릿은 Secret Manager를 통해 관리하며, --secrets를 사용하여 배포 시 주입합니다. 커스텀 인프라(Cloud SQL, Pub/Sub 등)는 Terraform에 작성해야 하며, gcloud를 수동으로 사용하여 생성하지 않습니다
- 롤백: 주로 git으로 수정한 후 파이프라인을 다시 실행합니다. Cloud Run은 이전 버전으로 트래픽을 전환할 수 있고, GKE는 kubectl rollout undo를 사용하며, Agent Runtime은 수정 후 재배포만 가능합니다
- 이틀 전에 등록된 publish, adk-code는 동일한 제품군입니다. skills.sh에서 24시간 동안 설치 횟수 4817, 누적 525087이며, 주간 설치 횟수는 최고점 132542에서 11134로 하락했습니다(이는 관심도를 나타냅니다)
사용법
- 설치 명령어는 감사 통과 후 표시됩니다(본 항목에는 위험 경고가 있음). CLI는 uv tool install google-agents-cli를 사용하여 설치합니다
- Google Cloud 프로젝트 및 해당 권한이 필요합니다. 프로젝트가 설정되지 않았다면 먼저 /google-agents-cli-scaffold를 사용하고, 전체 스킬 세트를 함께 설치하는 것이 가장 좋습니다
- "내 ADK 에이전트 배포", "CI/CD 설정", "시크릿 구성" 등을 말할 때 트리거됩니다. 프로젝트를 자동 해석할 때 비대화형 환경에서는 --no-confirm-project를 추가해야 합니다
위험
- 감사에서 지적한 설치, 셸, 네트워크 요청, 시크릿 읽기는 용도와 일치합니다: agents-cli를 설치해야 하며, 배포 자체가 GCP를 호출하고 Secret Manager의 시크릿을 처리합니다
- 감사에서 지적한 "원격 측정"은 선택적 관측성 구성(Cloud Trace, 프롬프트 및 응답 로그를 사용자 프로젝트의 BigQuery에 저장)에 해당하며, 서드파티로 보고하는 것이 아닙니다. 활성화하면 프롬프트 내용이 데이터베이스에 저장됩니다
- 배포, IAM 권한 부여, Terraform apply는 실제 클라우드 리소스를 변경하고 비용을 발생시킵니다. references/ 디렉터리의 상세 문서는 스캔되지 않았습니다