本文へ移動
cccskills
無料GitHub で公開

conoha-cli

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

crowdy/conoha-cli
インストール方法を見る

含まれるファイル（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（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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）も記載する

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く
このスキルの問題を報告する