Skip to content
cccskills
FreePublished on GitHub

conoha-cli

ConoHa VPS3 CLIによるインフラ構築スキル。サーバー作成、アプリデプロイ、 Kubernetesクラスター、OpenStackプラットフォーム、Slurmクラスターの構築を支援。「ConoHaでサーバーを作って」「k8sクラスターを構築して」「アプリをデプロイして」 などのリクエストでトリガー。

The English summary is being prepared. Showing the original description.

crowdy/conoha-cli
Works withGitHubKubernetes
See how to install

Files included (200)

  • SKILL.md7.7 KB
  • .github/workflows/ci.yml1.8 KB
  • .github/workflows/gitleaks.yml422 B
  • .github/workflows/release.yml1.9 KB
  • .gitignore594 B
  • .golangci.yml508 B
  • .goreleaser.yaml1.7 KB
  • banner.svg3.0 KB
  • cmd/app/app.go471 B
  • cmd/app/compose_test.go1.3 KB
  • cmd/app/compose.go1.5 KB
  • cmd/app/connect_test.go4.3 KB
  • cmd/app/connect.go4.7 KB
  • cmd/app/deploy_multiblock_test.go10.5 KB
  • cmd/app/deploy_ops_test.go11.7 KB
  • cmd/app/deploy_ops.go3.4 KB
  • cmd/app/deploy_test.go1.7 KB
  • cmd/app/deploy.go18.0 KB
  • cmd/app/deployblocks.go3.6 KB
  • cmd/app/destroy_test.go2.7 KB
  • cmd/app/destroy.go3.6 KB
  • cmd/app/dockerignore_test.go2.4 KB
  • cmd/app/dockerignore.go1.8 KB
  • cmd/app/env_test.go3.6 KB
  • cmd/app/env.go9.9 KB
  • cmd/app/init_test.go1.4 KB
  • cmd/app/init.go7.1 KB
  • cmd/app/list_test.go2.1 KB
  • cmd/app/list.go3.5 KB
  • cmd/app/logs_test.go1.2 KB
  • cmd/app/logs.go2.4 KB
  • cmd/app/mode_test.go7.7 KB
  • cmd/app/mode.go9.7 KB
  • cmd/app/override_test.go1.4 KB
  • cmd/app/override.go3.2 KB
  • cmd/app/proxyservices_test.go7.7 KB
  • cmd/app/proxyservices.go3.7 KB
  • cmd/app/remotecmds_test.go3.1 KB
  • cmd/app/remotecmds.go5.9 KB
  • cmd/app/reset_test.go1.5 KB
  • cmd/app/reset.go8.0 KB
  • cmd/app/restart_test.go903 B
  • cmd/app/restart.go1.7 KB
  • cmd/app/rollback_test.go6.9 KB
  • cmd/app/rollback.go6.1 KB
  • cmd/app/slot_test.go1.6 KB
  • cmd/app/slot.go1.9 KB
  • cmd/app/status_test.go10.1 KB
  • cmd/app/status.go8.7 KB
  • cmd/app/stop_test.go870 B
  • cmd/app/stop.go2.0 KB
  • cmd/app/tar_test.go1.9 KB
  • cmd/app/tar.go1.2 KB
  • cmd/auth/auth.go8.0 KB
  • cmd/cmdutil/args_test.go874 B
  • cmd/cmdutil/args.go396 B
  • cmd/cmdutil/client.go1.5 KB
  • cmd/cmdutil/format_test.go1.4 KB
  • cmd/cmdutil/format.go1.3 KB
  • cmd/cmdutil/wait_test.go1.5 KB
  • cmd/cmdutil/wait.go2.1 KB
  • cmd/completion.go1.0 KB
  • cmd/config/config.go1.7 KB
  • cmd/dns/dns.go6.0 KB
  • cmd/flavor/flavor.go2.2 KB
  • cmd/gpu/gpu.go560 B
  • cmd/gpu/setup.go8.4 KB
  • cmd/identity/identity.go3.7 KB
  • cmd/image/image.go6.3 KB
  • cmd/keypair/keypair.go4.9 KB
  • cmd/lb/healthmonitor.go4.9 KB
  • cmd/lb/lb.go4.0 KB
  • cmd/lb/listener.go4.1 KB
  • cmd/lb/member.go4.5 KB
  • cmd/lb/pool.go4.0 KB
  • cmd/network/network.go13.1 KB
  • cmd/proxy/boot.go2.7 KB
  • cmd/proxy/lifecycle.go5.3 KB
  • cmd/proxy/observability_test.go2.9 KB
  • cmd/proxy/observability.go4.0 KB
  • cmd/proxy/proxy.go2.7 KB
  • cmd/root.go4.6 KB
  • cmd/server/create_test.go11.0 KB
  • cmd/server/create.go20.8 KB
  • cmd/server/deploy_test.go1.1 KB
  • cmd/server/deploy.go2.5 KB
  • cmd/server/lifecycle.go10.1 KB
  • cmd/server/list_test.go2.6 KB
  • cmd/server/list.go8.0 KB
  • cmd/server/metadata.go1.4 KB
  • cmd/server/open_port_test.go4.8 KB
  • cmd/server/open_port.go8.1 KB
  • cmd/server/preset_test.go12.4 KB
  • cmd/server/preset.go4.2 KB
  • cmd/server/security_group_test.go1.3 KB
  • cmd/server/security_group.go2.3 KB
  • cmd/server/server_test.go372 B
  • cmd/server/server.go1.4 KB
  • cmd/server/ssh_test.go169 B
  • cmd/server/ssh.go1.7 KB
  • cmd/server/volume_attach.go1.0 KB
  • cmd/skill/skill_test.go3.3 KB
  • cmd/skill/skill.go3.4 KB
  • cmd/storage/storage.go9.8 KB
  • cmd/version_test.go632 B
  • cmd/version.go765 B
  • cmd/volume/volume_test.go12.8 KB
  • cmd/volume/volume.go10.0 KB
  • CONTRIBUTING.md2.5 KB
  • docs/articles/2026-04-05-note-conoha-cli.md18.8 KB
  • docs/flavors.md1.8 KB
  • docs/release-checklist.md12.0 KB
  • docs/roadmap.md11.9 KB
  • docs/startup-script.md2.1 KB
  • docs/superpowers/plans/2026-03-27-v0110-lb-image.md44.0 KB
  • docs/superpowers/plans/2026-03-28-v020-testing-ci.md22.7 KB
  • docs/superpowers/plans/2026-03-28-v030-deploy-impl.md30.9 KB
  • docs/superpowers/plans/2026-03-28-v031-app-lifecycle-impl.md26.8 KB
  • docs/superpowers/plans/2026-03-28-v032-app-management-impl.md16.2 KB
  • docs/superpowers/plans/2026-03-29-docs-site-impl.md45.4 KB
  • docs/superpowers/plans/2026-03-31-app-samples-impl.md32.3 KB
  • docs/superpowers/plans/2026-03-31-app-samples-tier1-impl.md40.4 KB
  • docs/superpowers/plans/2026-03-31-app-samples-tier2-impl.md36.8 KB
  • docs/superpowers/plans/2026-03-31-app-samples-tier3-impl.md910 B
  • docs/superpowers/plans/2026-03-31-server-security-group-commands.md7.4 KB
  • docs/superpowers/plans/2026-04-01-conoha-cli-skill-impl.md38.6 KB
  • docs/superpowers/plans/2026-04-01-figma-to-deploy-impl.md10.0 KB
  • docs/superpowers/plans/2026-04-01-skill-commands-impl.md10.1 KB
  • docs/superpowers/plans/2026-04-02-server-create-non-tty-impl.md12.0 KB
  • docs/superpowers/plans/2026-04-02-volume-improvements-impl.md20.9 KB
  • docs/superpowers/plans/2026-04-07-app-reset.md7.4 KB
  • docs/superpowers/plans/2026-04-09-compose-file-support.md12.1 KB
  • docs/superpowers/plans/2026-04-20-conoha-proxy-deploy.md87.1 KB
  • docs/superpowers/plans/2026-04-21-no-proxy-mode.md56.7 KB
  • docs/superpowers/plans/2026-04-21-readme-skill-noproxy-refresh.md46.4 KB
  • docs/superpowers/plans/2026-04-26-server-create-proxy-preset.md27.1 KB
  • docs/superpowers/specs/2026-03-27-v0110-lb-image-design.md16.2 KB
  • docs/superpowers/specs/2026-03-28-v020-testing-ci-design.md8.7 KB
  • docs/superpowers/specs/2026-03-28-v030-deploy-design.md21.8 KB
  • docs/superpowers/specs/2026-03-28-v031-app-lifecycle-design.md20.2 KB
  • docs/superpowers/specs/2026-03-28-v032-app-management-design.md9.1 KB
  • docs/superpowers/specs/2026-03-29-docs-site-design.md5.7 KB
  • docs/superpowers/specs/2026-03-30-homebrew-tap-design.md2.0 KB
  • docs/superpowers/specs/2026-03-31-app-samples-design.md6.2 KB
  • docs/superpowers/specs/2026-03-31-server-security-group-commands-design.md2.3 KB
  • docs/superpowers/specs/2026-04-01-conoha-cli-skill-design.md5.7 KB
  • docs/superpowers/specs/2026-04-01-figma-to-deploy-design.md4.8 KB
  • docs/superpowers/specs/2026-04-01-skill-commands-design.md2.4 KB
  • docs/superpowers/specs/2026-04-02-server-create-non-tty-design.md2.2 KB
  • docs/superpowers/specs/2026-04-02-volume-improvements-design.md2.4 KB
  • docs/superpowers/specs/2026-04-05-note-article-design.md6.3 KB
  • docs/superpowers/specs/2026-04-07-app-reset-design.md1.8 KB
  • docs/superpowers/specs/2026-04-09-compose-file-support-design.md3.5 KB
  • docs/superpowers/specs/2026-04-20-conoha-proxy-deploy-design.md18.4 KB
  • docs/superpowers/specs/2026-04-21-no-proxy-mode-design.md19.0 KB
  • docs/superpowers/specs/2026-04-23-app-env-redesign.md14.6 KB
  • docs/superpowers/specs/2026-04-23-e2e-tests-design.md13.5 KB
  • docs/superpowers/specs/2026-04-24-subdomain-split-design.md32.9 KB
  • docs/superpowers/specs/2026-04-26-server-create-proxy-preset-design.md8.0 KB
  • go.mod426 B
  • go.sum2.5 KB
  • internal/api/auth_test.go5.9 KB
  • internal/api/auth.go4.5 KB
  • internal/api/client_test.go5.2 KB
  • internal/api/client.go6.3 KB
  • internal/api/compute_test.go25.8 KB
  • internal/api/compute.go9.3 KB
  • internal/api/debug_test.go4.9 KB
  • internal/api/debug.go3.5 KB
  • internal/api/dns_test.go11.4 KB
  • internal/api/dns.go2.5 KB
  • internal/api/identity_test.go9.4 KB
  • internal/api/identity.go2.6 KB
  • internal/api/image_edgecase_test.go3.3 KB
  • internal/api/image_test.go7.2 KB
  • internal/api/image.go4.2 KB
  • internal/api/loadbalancer_test.go26.6 KB
  • internal/api/loadbalancer.go6.9 KB
  • internal/api/network_test.go34.1 KB
  • internal/api/network.go9.1 KB
  • internal/api/objectstorage_test.go10.5 KB
  • internal/api/objectstorage.go4.1 KB
  • internal/api/testutil_test.go174 B
  • internal/api/volume_test.go9.5 KB
  • internal/api/volume.go2.4 KB
  • internal/config/config_test.go6.9 KB
  • internal/config/config.go1.9 KB
  • internal/config/credentials.go1.4 KB
  • internal/config/env.go1.7 KB
  • internal/config/projectfile_test.go10.0 KB
  • internal/config/projectfile.go9.0 KB
  • internal/config/tokens.go1.6 KB
  • internal/errors/errors_test.go2.7 KB
  • internal/errors/errors.go3.1 KB
  • internal/errors/exitcodes.go391 B
  • internal/model/dns_test.go2.6 KB
  • internal/model/dns.go3.0 KB
  • internal/model/flavor.go363 B
  • internal/model/identity.go909 B
  • internal/model/image.go1.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

ConoHa CLI スキル

ConoHa VPS3 CLIを使ったインフラ構築ガイド。

前提条件

  • conoha-cli がインストール済みであること
  • conoha auth login で認証済みであること
  • SSHキーペアが登録済みであること（conoha keypair create <name>）

基本操作

サーバー管理

コマンド説明
conoha server listサーバー一覧を表示する
conoha server create --name <名前> --flavor <ID> --image <ID> --key-name <キー名>サーバーを作成する
conoha server create --name <名前> --waitサーバー作成完了まで待機する
conoha server show <ID|名前>サーバー詳細を表示する
conoha server delete <ID|名前>サーバーを削除する
conoha server deploy <ID|名前> --script <ファイル> --env KEY=VALUEスクリプトをSSH経由で実行する

フレーバー・イメージ

コマンド説明
conoha flavor list利用可能なフレーバー一覧を表示する
conoha image list利用可能なイメージ一覧を表示する

ネットワーク

コマンド説明
conoha network listネットワーク一覧を表示する
conoha network create --name <名前>プライベートネットワークを作成する
conoha network subnet create --network-id <ID> --cidr <CIDR>サブネットを作成する
conoha network sg listセキュリティグループ一覧を表示する
conoha network sg create --name <名前>セキュリティグループを作成する
conoha network sgr create --security-group-id <ID> --direction ingress --protocol tcp --port-min <ポート> --port-max <ポート> --remote-ip <CIDR>セキュリティグループルールを追加する

キーペア

コマンド説明
conoha keypair listキーペア一覧を表示する
conoha keypair create <名前>キーペアを作成する

アプリデプロイ（conoha-proxy 経由 blue/green）

v0.2.0 から conoha app deploy は conoha-proxy 経由の blue/green デプロイに統一。Let's Encrypt TLS と Host ヘッダールーティングを含む。初回セットアップは「proxy boot → app init → app deploy」の 3 ステップ。

前提：レポルートに conoha.yml（name / hosts / web.service / web.port を宣言）。

コマンド説明
conoha proxy boot <ID|名前> --acme-email <mail>conoha-proxy コンテナをサーバーに起動する
conoha proxy reboot <ID|名前> --acme-email <mail>プロキシイメージを更新して再起動する
conoha proxy logs <ID|名前> --followプロキシのログを見る
conoha proxy details <ID|名前>プロキシのバージョン・readiness を表示する
conoha proxy services <ID|名前>登録されている service 一覧を表示する
conoha app init <ID|名前>conoha.yml を proxy に service として登録する
conoha app deploy <ID|名前>新 slot を立ち上げて proxy に probe + swap を依頼（blue/green）
conoha app rollback <ID|名前>drain 窓内で直前の slot にスワップバックする
conoha app status <ID|名前>compose ps + proxy の phase / active / draining を表示する
conoha app logs <ID|名前> --followアプリのログをストリーミング表示する
conoha app stop <ID|名前>アプリのコンテナを停止する
conoha app restart <ID|名前>アプリのコンテナを再起動する
conoha app destroy <ID|名前>全 slot を停止して proxy から service を削除する

.env.server の代わりに blue/green スロットごとに conoha-override.yml が注入され、host ポートは kernel 割当（127.0.0.1:0:<web.port>）。compose ファイルに host 側ポートをハードコードしないこと。

レシピ一覧

ユーザーのリクエストに応じて、該当するレシピファイルを読み込んで手順を実行する。

レシピ用途ファイル
シングルサーバーアプリDocker Composeアプリのデプロイrecipes/single-server-app.md
シングルサーバースクリプトカスタムスクリプトによるセットアップrecipes/single-server-script.md
Kubernetesクラスターk3sによるマルチノードk8sクラスターrecipes/k8s-cluster.md
OpenStackプラットフォームDevStackによるOpenStack環境recipes/openstack-platform.md
SlurmクラスターHPCジョブスケジューラクラスターrecipes/slurm-cluster.md

共通パターン

マルチサーバー作成

複数サーバーを作成する場合、命名規則を統一する：

# 例: k8sクラスター
conoha server create --name k8s-master-1 --flavor <ID> --image <ID> --key-name <キー名> --security-group <SG名> --wait
conoha server create --name k8s-worker-1 --flavor <ID> --image <ID> --key-name <キー名> --security-group <SG名> --wait
conoha server create --name k8s-worker-2 --flavor <ID> --image <ID> --key-name <キー名> --security-group <SG名> --wait

セキュリティグループの事前準備

クラスター構築前に必要なポートを開放するセキュリティグループを作成する：

# セキュリティグループ作成
conoha network sg create --name <クラスター名>-sg

# 必要なルールを追加（例: SSH + クラスター固有ポート）
conoha network sgr create --security-group-id <SG-ID> --direction ingress --protocol tcp --port-min 22 --port-max 22 --remote-ip 0.0.0.0/0

デプロイスクリプト実行順序

マルチサーバー構成では以下の順序で実行する：

  1. 全ノード共通の初期設定スクリプトを実行する
  2. マスター/コントローラーノードのセットアップスクリプトを実行する
  3. マスターからジョイン情報（トークン等）を取得する
  4. ワーカー/コンピュートノードのセットアップスクリプトを実行する（ジョイン情報を--envで渡す）
# 1. 全ノード共通
conoha server deploy <各ノード> --script common-setup.sh

# 2. マスターセットアップ
conoha server deploy <マスター> --script master-setup.sh

# 3. ジョイン情報取得（SSH経由）
TOKEN=$(ssh root@<マスターIP> "取得コマンド")

# 4. ワーカーセットアップ
conoha server deploy <ワーカー> --script worker-setup.sh --env JOIN_TOKEN=$TOKEN

問題報告

conoha-cli の使用中に異常な動作や予期しないエラーを発見した場合、gh コマンドが利用可能であれば GitHub Issue を自動登録する：

gh issue create --repo crowdy/conoha-cli --title "<エラーの要約>" --body "<再現手順と詳細>"
  • 再現手順、実行したコマンド、エラーメッセージを含める
  • 可能であれば conoha-cli のバージョン（conoha version）も記載する

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Report a problem with this skill