@bifos/nhncloud-cli 0.6.0 → 0.7.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 CHANGED
@@ -1,8 +1,8 @@
1
1
  # nhncloud-cli
2
2
 
3
3
  NHN Cloud 서비스를 AWS CLI 방식으로 호출하는 통합 CLI.
4
- 현재 81개 명령을 지원한다.
5
- `configure`, `logncrash search/send/export`, `deploy`, `instance`, `network`, `volume`, `floatingip`, `ncr`, `nks` 명령으로 NHN Cloud 서비스를 조회·운영할 수 있다.
4
+ 현재 98개 command catalog 항목을 지원한다.
5
+ `configure`, `commands`, `logncrash search/send/export`, `deploy`, `instance`, `network`, `volume`, `floatingip`, `ncr`, `nks` 명령으로 NHN Cloud 서비스를 조회·운영할 수 있다.
6
6
 
7
7
  ## 설치
8
8
 
@@ -200,8 +200,21 @@ nhncloud logncrash send --body "deploy 시작" --app-version 2.3.0 --source batc
200
200
  `--json`은 CLI가 가공한 출력 계약이다.
201
201
  NHN Cloud 또는 OpenStack 원본 응답의 최상위 래퍼를 그대로 보존하지 않을 수 있다.
202
202
 
203
+ ### 자동화와 AI 에이전트
204
+
205
+ 명령 경로, 인수, 옵션은 `nhncloud commands --json`으로 확인한다.
206
+ 이 명령은 외부 API를 호출하지 않고 Commander tree metadata만 stdout에 출력한다.
207
+
208
+ ```bash
209
+ nhncloud commands --json | jq '.commands[] | select(.path=="nks cluster list")'
210
+ ```
211
+
212
+ root와 주요 service group의 `--help`에는 짧은 agent hint가 포함된다.
213
+ 긴 사용법은 README와 공개 skill reference를 기준으로 확인한다.
214
+
203
215
  | 명령 | `--json` 출력 shape |
204
216
  |------|---------------------|
217
+ | `commands` | `{ commands: [{ path, description, arguments, options, subcommands }] }` |
205
218
  | `logncrash search` | `{ totalItems, pageNumber, pageSize, data }` 객체 |
206
219
  | `logncrash export` | 파일 출력 전용. stdout JSON 없음 |
207
220
  | `deploy artifacts` | Deploy API `body` 객체 |
@@ -471,6 +484,9 @@ nhncloud volume create --size 10
471
484
  # 이름·타입 지정
472
485
  nhncloud volume create --size 50 --name my-volume --volume-type "General SSD"
473
486
 
487
+ # 인스턴스와 같은 가용성 영역에 생성
488
+ nhncloud volume create --size 50 --volume-type "General SSD" --availability-zone kr-pub-a
489
+
474
490
  # 인스턴스에 연결된 볼륨 목록 조회
475
491
  nhncloud instance volumes <instance-id>
476
492
 
@@ -644,4 +660,5 @@ node dist/index.js instance --help
644
660
  node dist/index.js logncrash search --help
645
661
  node dist/index.js ncr --help
646
662
  node dist/index.js nks --help
663
+ node dist/index.js commands --json
647
664
  ```