@bifos/nhncloud-cli 0.8.0 → 0.10.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 +29 -4
- package/dist/index.js +5177 -4897
- package/package.json +1 -1
- package/skills/nhncloud-cli/references/ncs.md +1 -2
package/README.md
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
NHN Cloud 서비스를 AWS CLI 방식으로 호출하는 통합 CLI.
|
|
4
4
|
현재 106개 command catalog 항목을 지원한다.
|
|
5
5
|
`configure`, `commands`, `logncrash search/send/export`, `deploy`, `instance`, `network`, `volume`, `floatingip`, `ncr`, `nks`, `ncs` 명령으로 NHN Cloud 서비스를 조회·운영할 수 있다.
|
|
6
|
+
`skills`/`doctor` 로 Claude Code 스킬 설치와 상태 진단을 지원한다.
|
|
6
7
|
|
|
7
8
|
## 설치
|
|
8
9
|
|
|
@@ -18,15 +19,18 @@ npm install -g @bifos/nhncloud-cli
|
|
|
18
19
|
nhncloud configure
|
|
19
20
|
```
|
|
20
21
|
|
|
21
|
-
- profile → UAK(id/secret) → logncrash appkey/secret → iaas 자격증명 → ncr appkey 순으로 입력한다.
|
|
22
|
+
- profile → UAK(id/secret) → logncrash appkey/secret → iaas 자격증명 → ncr appkey → ncs appkey 순으로 입력한다.
|
|
23
|
+
- profile 은 프로젝트 단위다 — 여러 NHN Cloud 프로젝트를 쓰면 profile 을 분리하되, 같은 UAK 를 쓴다면
|
|
24
|
+
대화형 마법사가 기존 profile 의 UAK 재사용 여부를 먼저 물어 재입력을 줄여준다.
|
|
22
25
|
- 저장 전 연결 테스트를 자동으로 수행한다 (`--no-verify` 로 생략 가능).
|
|
23
26
|
- CI/자동화는 flag 로 비대화형 설정이 가능하다.
|
|
24
27
|
|
|
25
28
|
```bash
|
|
26
|
-
# UAK + logncrash 비대화형 설정
|
|
29
|
+
# UAK + logncrash + ncs 비대화형 설정
|
|
27
30
|
nhncloud configure \
|
|
28
31
|
--uak-id <id> --uak-secret <secret> \
|
|
29
32
|
--logncrash-appkey <key> --logncrash-secret <secret> \
|
|
33
|
+
[--ncs-appkey <appkey>] \
|
|
30
34
|
--no-verify
|
|
31
35
|
|
|
32
36
|
# iaas (Compute) 비대화형 설정 — API 비밀번호는 env 권장
|
|
@@ -48,6 +52,28 @@ NHNCLOUD_IAAS_PASSWORD=<api-password> nhncloud configure \
|
|
|
48
52
|
|
|
49
53
|
profile 해석 우선순위: `--profile` 옵션 > `NHNCLOUD_PROFILE` 환경변수 > `config.defaultProfile` > `"default"`.
|
|
50
54
|
|
|
55
|
+
### Claude Code 스킬 설치 (선택)
|
|
56
|
+
|
|
57
|
+
Claude Code 에서 이 CLI 를 AI 에이전트 스킬로 쓰려면 스킬을 `~/.claude/skills` 에 설치한다.
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
# 심볼릭 링크로 설치 (전역 설치 전제 — npx 환경은 불가)
|
|
61
|
+
nhncloud skills install
|
|
62
|
+
|
|
63
|
+
# 설치 상태 확인
|
|
64
|
+
nhncloud skills
|
|
65
|
+
|
|
66
|
+
# 제거
|
|
67
|
+
nhncloud skills uninstall
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### 상태 진단
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 자격증명·스킬 설치 상태를 오프라인으로 진단
|
|
74
|
+
nhncloud doctor
|
|
75
|
+
```
|
|
76
|
+
|
|
51
77
|
## 사용 예
|
|
52
78
|
|
|
53
79
|
### 배포 (Deploy)
|
|
@@ -655,8 +681,7 @@ nhncloud nks nodegroup set-labels <cluster> worker --file ./labels.json
|
|
|
655
681
|
NCS는 template(설계도)과 workload(런타임 실행)를 조회한다.
|
|
656
682
|
인증은 Deploy와 같은 UAK OAuth Bearer 토큰을 재사용하며(profile 토큰 캐시 공유), appkey는 경로에 포함한다.
|
|
657
683
|
지원 region은 `kr1`(판교), `kr3`(광주)만이다.
|
|
658
|
-
`configure`
|
|
659
|
-
`profiles.<profile>.ncs.appkey`를 직접 추가한다.
|
|
684
|
+
appkey는 `nhncloud configure` (대화형 또는 `--ncs-appkey`) 로 설정하거나 `--app-key` 옵션으로 직접 넘긴다.
|
|
660
685
|
|
|
661
686
|
template(설계도)의 생성·삭제, workload(런타임 실행)의 생성·변경·실행제어(일시정지/재개/재시작/삭제), 악성코드 검사(malware) 설정·결과 조회를 지원한다.
|
|
662
687
|
|