開発者

クイックスタート：登録から最初のサーバーまで

サーバーは標準の CloudStack API で管理するため、コマンドラインツール cmk と Claude Code をそのまま使えます。

1. アカウントを作成

   登録してメールを確認し、本人確認を済ませます。承認されるとクラウドコンソールのアカウントが開設され、チャージできるようになります。

   アカウントを作成

2. API キーを生成

   アカウントページからクラウドコンソールを開き、右上のメニューからプロフィールに入って「Generate keys」を選びます。API キーとシークレットキーが発行されます。

3. cmk をインストールして設定

   cmk（CloudMonkey）は CloudStack 公式のコマンドラインツールです。お使いの OS 用をダウンロードし、SOFT Cloud を指すよう設定します。キーはご自身のマシンの ~/.cmk/config に保存されます。

   # https://github.com/apache/cloudstack-cloudmonkey/releases
   cmk set url https://console.soft.cc/client/api
   cmk set apikey    <API Key>
   cmk set secretkey <Secret Key>
   cmk sync

4. 最初のサーバーを起動

   ゾーン、サイズ、イメージを確認してから作成します。料金は 1 時間ごとに残高から差し引かれます。外部から SSH で入るには、コンソールでパブリック IP とポートフォワーディングを設定してください。イメージは SSH 鍵のみ対応で、ログインユーザーはイメージに応じて ubuntu、debian、rocky です。

   cmk register sshkeypair name=me publickey="$(cat ~/.ssh/id_ed25519.pub)"
   cmk list zones filter=id,name
   cmk list serviceofferings filter=id,name,cpunumber,memory
   cmk list templates templatefilter=executable filter=id,name
   cmk deploy virtualmachine name=dev-01 keypair=me \
       zoneid=<zone> serviceofferingid=<offering> templateid=<template>
   # Ubuntu: ubuntu · Debian: debian · Rocky Linux: rocky
   ssh -p <port> ubuntu@<public IP>

5. Claude Code に任せる

   ターミナルで cmk が動けば、Claude Code からも使えます。プロジェクトの CLAUDE.md に数行加えて、あとは普段の言葉で頼むだけです。

   # CLAUDE.md
   ## SOFT Cloud
   - Manage servers with `cmk` (CloudStack CLI, already configured).
   - Ask me before creating, resizing or deleting anything: it is billed hourly.
   - The database URL is in the DATABASE_URL environment variable.

   > 2 コア・4 GB の Ubuntu サーバーを dev-01 という名前で作って、Docker を入れて。

   シークレットキーをチャットに貼り付けないでください。cmk の設定か環境変数に置いてください。

6. PostgreSQL に接続

   「データベース」ページで注文します。稼働すると詳細ページに接続文字列が表示されます。TLS 接続のみ受け付けます。

   export DATABASE_URL='postgresql://app:<password>@<host>:<port>/app?sslmode=require'
   psql "$DATABASE_URL"

DISM /online /Get-CurrentEdition            # ServerStandardEval
# Datacenter: /Set-Edition:ServerDatacenter
DISM /online /Set-Edition:ServerStandard /ProductKey:XXXXX-XXXXX-XXXXX-XXXXX-XXXXX /AcceptEula
# restart (it restarts once more by itself), then:
slmgr /skms <your KMS>                     # only if you use your own KMS
slmgr /ato
slmgr /dlv                                  # License Status: Licensed