@bifos/nhncloud-cli 0.19.0 → 0.21.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -5
- package/dist/index.js +1207 -297
- package/package.json +4 -3
- package/skills/nhncloud-cli/SKILL.md +1 -1
- package/skills/nhncloud-cli/references/common.md +128 -11
- package/skills/nhncloud-cli/references/skm.md +32 -0
- package/skills/nhncloud-cli/references/troubleshooting.md +3 -1
package/README.md
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
NHN 이 만든 공식 제품이 아니에요.
|
|
10
10
|
|
|
11
11
|
인스턴스, 네트워크, 로드밸런서, Kubernetes, 컨테이너 레지스트리와 컨테이너 서비스, 로그 검색, 배포, API Gateway, 키 관리를 명령 한 줄로 다루고, 결과를 `--json` 으로 내보내요.
|
|
12
|
-
Claude Code 에 스킬로 설치하면 "인스턴스 목록 보여줘" 같은 말을 그대로 알아듣고 처리해요.
|
|
12
|
+
Claude Code 나 Codex 에 스킬로 설치하면 "인스턴스 목록 보여줘" 같은 말을 그대로 알아듣고 처리해요.
|
|
13
13
|
|
|
14
14
|
```bash
|
|
15
15
|
npm install -g @bifos/nhncloud-cli
|
|
@@ -33,7 +33,7 @@ nhncloud skills install
|
|
|
33
33
|
|
|
34
34
|
## 빠른 시작
|
|
35
35
|
|
|
36
|
-
Node.js 20 이상이 필요해요.
|
|
36
|
+
Node.js 20.18.1 이상이 필요해요.
|
|
37
37
|
|
|
38
38
|
### 1. 설치해요
|
|
39
39
|
|
|
@@ -63,9 +63,11 @@ nhncloud configure
|
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
65
|
nhncloud doctor
|
|
66
|
+
nhncloud doctor --check-connection # 대상 profile 의 실제 연결까지 확인
|
|
66
67
|
```
|
|
67
68
|
|
|
68
|
-
`doctor` 는 외부 API 를 호출하지 않고
|
|
69
|
+
`doctor` 는 기본으로 외부 API 를 호출하지 않고 자격증명, 설정 파일, 스킬 설치 상태를 확인해요.
|
|
70
|
+
`--check-connection` 을 주면 대상 profile 의 자격증명으로 실제 연결까지 확인해요.
|
|
69
71
|
|
|
70
72
|
### 4. 첫 명령을 실행해요
|
|
71
73
|
|
|
@@ -78,7 +80,8 @@ nhncloud network list --region kr1 # VPC 목록
|
|
|
78
80
|
|
|
79
81
|
### 5. AI 에이전트에 연결해요 (선택)
|
|
80
82
|
|
|
81
|
-
Claude Code 를 쓴다면 스킬을 설치해요. 에이전트가 이 CLI 의 사용법을 알게 돼요.
|
|
83
|
+
Claude Code 나 Codex 를 쓴다면 스킬을 설치해요. 에이전트가 이 CLI 의 사용법을 알게 돼요.
|
|
84
|
+
설치하면 Claude Code 의 `~/.claude/skills/nhncloud-cli` 와 Codex 의 `~/.agents/skills/nhncloud-cli` 에 함께 연결돼요.
|
|
82
85
|
|
|
83
86
|
```bash
|
|
84
87
|
nhncloud skills install
|
|
@@ -140,6 +143,8 @@ nhncloud apigateway service list # API Gateway 서
|
|
|
140
143
|
nhncloud apigateway stage deploy create <service-id> <stage-id> --yes # API Gateway 스테이지 배포
|
|
141
144
|
nhncloud skm key list <keystore-id> # Secure Key Manager 키 목록
|
|
142
145
|
nhncloud skm secret get <key-id> --quiet # 기밀 데이터 원문
|
|
146
|
+
nhncloud skm secret get <key-id> --field <name> --quiet # JSON 기밀 데이터의 필드 하나
|
|
147
|
+
printf '%s' "$VALUE" | nhncloud skm secret patch <key-id> <field> --replace --yes # JSON 기밀 데이터의 필드 하나만 바꾸기
|
|
143
148
|
```
|
|
144
149
|
|
|
145
150
|
삭제처럼 되돌리기 어려운 일부 명령은 `--yes` 를 붙여야 실행돼요. 비대화형 환경에서 `--yes` 가 없으면 API 를 호출하기 전에 끝나요.
|
|
@@ -183,8 +188,10 @@ nhncloud logncrash available-token --json | jq -r '.availableToken'
|
|
|
183
188
|
|
|
184
189
|
- 설정이 의심되면 `nhncloud doctor` 를 먼저 실행해 보세요.
|
|
185
190
|
- 에이전트가 새 명령을 모르면 `nhncloud skills update` 를 실행해 주세요.
|
|
191
|
+
- 프록시를 거쳐야 하면 `--proxy http://proxy.example:3128` 또는 `HTTPS_PROXY` 를 지정해요. 자세한 규칙은 [공통 가이드](skills/nhncloud-cli/references/common.md)의 「프록시」 절에 있어요.
|
|
186
192
|
- 종료 코드별 대처는 [문제 해결](skills/nhncloud-cli/references/troubleshooting.md)에 있어요.
|
|
187
|
-
- 버그나 제안은 [GitHub Issues](https://github.com/jon890/nhncloud-cli/issues) 에 남겨 주세요. 설정 문제라면 `nhncloud doctor` 출력을 함께 붙여 주세요.
|
|
193
|
+
- 버그나 제안은 [GitHub Issues](https://github.com/jon890/nhncloud-cli/issues) 에 남겨 주세요. 설정 문제라면 `nhncloud doctor --json` 출력을 함께 붙여 주세요.
|
|
194
|
+
비밀값은 출력에 들어가지 않지만 파일 경로에 사용자 이름이 보일 수 있으니 필요하면 가려 주세요.
|
|
188
195
|
|
|
189
196
|
## 기여하기
|
|
190
197
|
|