@bifos/nhncloud-cli 0.2.0 → 0.3.0

package/README.md

@@ -195,6 +195,16 @@ nhncloud instance create \
   --boot-volume-size 30 \
   --wait
 
+# cloud-init user-data 주입 (부팅 시 자동 셋업 — NVIDIA 드라이버·docker 등)
+nhncloud instance create \
+  --name gpu-runner \
+  --flavor <gpu-flavor-id> \
+  --image <image-id> \
+  --network <network-uuid> \
+  --boot-volume-size 30 \
+  --user-data ./cloud-init.yaml \
+  --wait
+
 # --quiet --wait: 첫 IP 한 줄만 stdout (CI 파이프용)
 IP=$(nhncloud instance create --name ci-runner \
   --flavor <flavor-id> --image <image-id> --network <network-uuid> \

package/dist/index.js

@@ -1310,6 +1310,7 @@ var InstanceClient = class {
   /**
    * 인스턴스를 생성한다 (POST /servers).
    * NHN 확장 필드(ephemeralDiskSize / protect)는 정의됐을 때만 payload 에 포함한다.
+   * userDataBase64 도 정의됐을 때만 `user_data` 로 포함한다 (인코딩은 command 단에서 완료).
    */
   async create(params) {
     const url = `${this.computeEndpoint}/servers`;
@@ -1344,6 +1345,9 @@ var InstanceClient = class {
     if (params.protect !== void 0) {
       serverBody["NHN-EXT-ATTR:protect"] = params.protect;
     }
+    if (params.userDataBase64 !== void 0) {
+      serverBody["user_data"] = params.userDataBase64;
+    }
     let raw;
     try {
       raw = await import_ky6.default.post(url, {
@@ -1480,6 +1484,7 @@ var getCommand = new import_commander8.Command("get").description("\uB2E8\uC77C
 
 // src/commands/instance/create.ts
 var import_commander9 = require("commander");
+var import_node_fs = require("fs");
 var import_chalk2 = __toESM(require("chalk"));
 function getFirstIp(server) {
   for (const list of Object.values(server.addresses)) {
@@ -1495,12 +1500,45 @@ function getIps3(server) {
 function getImageId2(server) {
   return typeof server.image === "object" ? server.image.id : "";
 }
-var createCommand = new import_commander9.Command("create").description("\uC778\uC2A4\uD134\uC2A4\uB97C \uC0DD\uC131\uD55C\uB2E4").requiredOption("--name <name>", "\uC778\uC2A4\uD134\uC2A4 \uC774\uB984").requiredOption("--flavor <id>", "flavor ID").requiredOption("--image <id>", "\uC774\uBBF8\uC9C0 ID").requiredOption("--network <uuid>", "\uB124\uD2B8\uC6CC\uD06C UUID (\uC5EC\uB7EC \uAC1C: \uBC18\uBCF5 \uC9C0\uC815)", (v, prev) => [...prev, v], []).option("--boot-volume-size <gb>", "boot-from-volume root \uBCFC\uB968 \uD06C\uAE30 (GB). GPU(g2) \uB4F1 boot-from-volume \uD544\uC218 flavor \uC5D0 \uC9C0\uC815").option("--key-name <name>", "\uD0A4\uD398\uC5B4 \uC774\uB984").option("--security-group <name>", "\uBCF4\uC548 \uADF8\uB8F9 \uC774\uB984 (\uC5EC\uB7EC \uAC1C: \uBC18\uBCF5 \uC9C0\uC815)", (v, prev) => [...prev, v], []).option("--ephemeral-disk-size <gb>", "\uC784\uC2DC \uB514\uC2A4\uD06C \uD06C\uAE30 (GB, NHN \uD655\uC7A5)").option("--protect", "\uC0AD\uC81C \uBC29\uC9C0 \uC124\uC815 (NHN \uD655\uC7A5)").option("--wait", "ACTIVE \uC0C1\uD0DC\uAC00 \uB420 \uB54C\uAE4C\uC9C0 \uB300\uAE30").option("--timeout <sec>", "wait \uD0C0\uC784\uC544\uC6C3 (\uCD08, \uAE30\uBCF8 300)", "300").option("--region <region>", "region override (\uAE30\uBCF8: iaas \uC790\uACA9\uC99D\uBA85\uC758 region)").option("--profile <name>", "\uC0AC\uC6A9\uD560 profile \uC774\uB984").action(async (_opts, cmd) => {
+var createCommand = new import_commander9.Command("create").description("\uC778\uC2A4\uD134\uC2A4\uB97C \uC0DD\uC131\uD55C\uB2E4").requiredOption("--name <name>", "\uC778\uC2A4\uD134\uC2A4 \uC774\uB984").requiredOption("--flavor <id>", "flavor ID").requiredOption("--image <id>", "\uC774\uBBF8\uC9C0 ID").requiredOption("--network <uuid>", "\uB124\uD2B8\uC6CC\uD06C UUID (\uC5EC\uB7EC \uAC1C: \uBC18\uBCF5 \uC9C0\uC815)", (v, prev) => [...prev, v], []).option("--boot-volume-size <gb>", "boot-from-volume root \uBCFC\uB968 \uD06C\uAE30 (GB). GPU(g2) \uB4F1 boot-from-volume \uD544\uC218 flavor \uC5D0 \uC9C0\uC815").option("--key-name <name>", "\uD0A4\uD398\uC5B4 \uC774\uB984").option("--security-group <name>", "\uBCF4\uC548 \uADF8\uB8F9 \uC774\uB984 (\uC5EC\uB7EC \uAC1C: \uBC18\uBCF5 \uC9C0\uC815)", (v, prev) => [...prev, v], []).option("--ephemeral-disk-size <gb>", "\uC784\uC2DC \uB514\uC2A4\uD06C \uD06C\uAE30 (GB, NHN \uD655\uC7A5)").option("--protect", "\uC0AD\uC81C \uBC29\uC9C0 \uC124\uC815 (NHN \uD655\uC7A5)").option("--user-data <path>", "cloud-init user-data \uD30C\uC77C \uACBD\uB85C (base64 \uC778\uCF54\uB529\uD574 \uC8FC\uC785, \uC778\uCF54\uB529 \uD6C4 65535 \uBC14\uC774\uD2B8 \uD55C\uB3C4)").option("--wait", "ACTIVE \uC0C1\uD0DC\uAC00 \uB420 \uB54C\uAE4C\uC9C0 \uB300\uAE30").option("--timeout <sec>", "wait \uD0C0\uC784\uC544\uC6C3 (\uCD08, \uAE30\uBCF8 300)", "300").option("--region <region>", "region override (\uAE30\uBCF8: iaas \uC790\uACA9\uC99D\uBA85\uC758 region)").option("--profile <name>", "\uC0AC\uC6A9\uD560 profile \uC774\uB984").action(async (_opts, cmd) => {
   const opts = cmd.optsWithGlobals();
   const networks = opts.network ?? [];
   if (networks.length === 0) {
     throw new NhnCloudCliError("--network \uB294 \uCD5C\uC18C 1\uAC1C \uD544\uC694\uD569\uB2C8\uB2E4.", EXIT_PARAM_ERROR);
   }
+  let userDataBase64;
+  if (opts.userData !== void 0) {
+    let stat;
+    try {
+      stat = (0, import_node_fs.statSync)(opts.userData);
+    } catch (e) {
+      const reason = e.code ?? (e instanceof Error ? e.message : String(e));
+      throw new NhnCloudCliError(
+        `--user-data \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${opts.userData} (${reason})`,
+        EXIT_PARAM_ERROR
+      );
+    }
+    if (!stat.isFile()) {
+      throw new NhnCloudCliError(
+        `--user-data \uAC00 \uC77C\uBC18 \uD30C\uC77C\uC774 \uC544\uB2D9\uB2C8\uB2E4: ${opts.userData}`,
+        EXIT_PARAM_ERROR
+      );
+    }
+    if (stat.size > 49149) {
+      throw new NhnCloudCliError(
+        `--user-data \uAC00 \uB108\uBB34 \uD07D\uB2C8\uB2E4 (${stat.size} \uBC14\uC774\uD2B8). base64 \uC778\uCF54\uB529 \uD6C4 65535 \uBC14\uC774\uD2B8 \uD55C\uB3C4\uB77C raw 49149 \uBC14\uC774\uD2B8\uAE4C\uC9C0\uB9CC \uD5C8\uC6A9\uB429\uB2C8\uB2E4.`,
+        EXIT_PARAM_ERROR
+      );
+    }
+    const raw = (0, import_node_fs.readFileSync)(opts.userData);
+    userDataBase64 = raw.toString("base64");
+    if (userDataBase64.length > 65535) {
+      throw new NhnCloudCliError(
+        `--user-data \uAC00 base64 \uC778\uCF54\uB529 \uD6C4 65535 \uBC14\uC774\uD2B8\uB97C \uCD08\uACFC\uD569\uB2C8\uB2E4 (${userDataBase64.length} \uBC14\uC774\uD2B8). cloud-init \uB0B4\uC6A9\uC744 \uC904\uC774\uC138\uC694.`,
+        EXIT_PARAM_ERROR
+      );
+    }
+  }
   const timeoutMs = parseInt(opts.timeout ?? "300", 10) * 1e3;
   const { client } = await resolveInstanceClient(opts);
   startSpinner("\uC778\uC2A4\uD134\uC2A4 \uC0DD\uC131 \uC911...");
@@ -1515,7 +1553,8 @@ var createCommand = new import_commander9.Command("create").description("\uC778\
       keyName: opts.keyName,
       securityGroups: opts.securityGroup && opts.securityGroup.length > 0 ? opts.securityGroup : void 0,
       ephemeralDiskSize: opts.ephemeralDiskSize !== void 0 ? parseInt(opts.ephemeralDiskSize, 10) : void 0,
-      protect: opts.protect
+      protect: opts.protect,
+      userDataBase64
     });
   } catch (err) {
     stopSpinner(false);
@@ -1595,7 +1634,7 @@ var deleteCommand = new import_commander10.Command("delete").description("\uC778
 
 // src/index.ts
 var program = new import_commander11.Command();
-program.name("nhncloud").description("NHN Cloud CLI \u2014 AI agent & terminal friendly").version("0.2.0").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--quiet", "\uCD5C\uC18C \uCD9C\uB825 (\uC790\uB3D9\uD654\uC6A9)").option("--no-color", "\uC0C9\uC0C1 \uBE44\uD65C\uC131\uD654");
+program.name("nhncloud").description("NHN Cloud CLI \u2014 AI agent & terminal friendly").version("0.3.0").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--quiet", "\uCD5C\uC18C \uCD9C\uB825 (\uC790\uB3D9\uD654\uC6A9)").option("--no-color", "\uC0C9\uC0C1 \uBE44\uD65C\uC131\uD654");
 program.hook("preAction", () => {
   const opts = program.opts();
   if (!opts.color || process.env["NO_COLOR"]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bifos/nhncloud-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI tool for NHN Cloud services — AI agent & terminal friendly",
   "keywords": [
     "nhncloud",

package/skills/nhncloud-cli/SKILL.md

@@ -326,6 +326,7 @@ NHNCLOUD_IAAS_PASSWORD=<api-password> nhncloud configure \
 | `--security-group <name>` | 아니오 | 보안 그룹 이름 (반복 지정) |
 | `--ephemeral-disk-size <gb>` | 아니오 | 임시 디스크 크기(GB, NHN 확장) |
 | `--protect` | 아니오 | 삭제 방지 설정 (NHN 확장) |
+| `--user-data <path>` | 아니오 | cloud-init user-data 파일 경로. base64 인코딩해 `user_data` 주입 (인코딩 후 65535 바이트 한도, 초과 시 입력 오류). 부팅 시 드라이버·패키지 자동 셋업에 사용 |
 | `--wait` | 아니오 | ACTIVE 상태 + IP 할당까지 대기 |
 | `--timeout <sec>` | 아니오 | wait 타임아웃 (초, 기본 300) |
 | `--region <region>` | 아니오 | region override (kr1/kr2/kr3/jp1) |
@@ -356,6 +357,16 @@ nhncloud instance delete "$INSTANCE_ID" --yes
 
 # 4. 목록에서 id 만 추출
 nhncloud instance list --quiet
+
+# 5. cloud-init 으로 부팅 시 셋업 자동화 (일회성 GPU CI 러너)
+nhncloud instance create \
+  --name gpu-ci \
+  --flavor <gpu-flavor-id> \
+  --image <image-id> \
+  --network <network-uuid> \
+  --boot-volume-size 30 \
+  --user-data ./setup-nvidia-docker.yaml \
+  --wait --quiet
 ```
 
 ### instance 에러 코드