自分のWelleyサーバーを動かす

ホスト、DNS、メールを準備する

クイックスタートで求められる最低限の条件です。どのくらいの容量が必要かは、ユーザー数や使い方によって変わります。

Docker EngineとComposeをインストールする

お使いのLinuxディストリビューション向けの、Docker公式の手順に従ってください。そのあと、デプロイに使うユーザーがDockerを使えるようにします。

Docker Engineのインストール

sudo usermod -aG docker <user>

docker ps
docker compose version

CLIをダウンロードする

CLIを実行するマシンに合ったバイナリーを選んでください。デプロイ先のホスト自体は、Linuxである必要があります。

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/amd64" -o wlycli
chmod +x wlycli
./wlycli -v

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/arm64" -o wlycli
chmod +x wlycli
./wlycli -v

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/arm64" -o wlycli
chmod +x wlycli
./wlycli -v

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/amd64" -o wlycli
chmod +x wlycli
./wlycli -v

• これらのコマンドは、stableチャンネルからダウンロードし、CLIのバージョンを表示します。
• バージョンは新しいリリースごとに変わります。インストールするときは、最新のCLIドキュメントを確認してください。

デプロイを作成する

準備したLinuxホストで、このコマンドを実行してください。例のドメイン、メールアドレス、SMTPの値は、自分のものに置き換えてください。

./wlycli deploy create \
-d example.com \
-e admin@example.com \
--smtp-host smtp.example.com \
--smtp-user "$MAIL_USER" \
--smtp-password "$MAIL_PASSWORD" \
--smtp-from noreply@example.com

• 実行する前に、MAIL_USERとMAIL_PASSWORDに、SMTPの認証情報を設定してください。
• クイックスタートでは、この6つのフラグが必須です。
• このコマンドはDNSを確認し、デプロイ用のファイルを書き出し、Certbotで証明書を取得して、コンテナを起動します。
• deployコマンドは、deploymentのエイリアスです。

ログインして結果を確認する

生成された管理者パスワードは、プラットフォームのログに出力されます。その出力は人に見せないでください。

docker logs example_com-platform-blue-1 | grep "Auto-init complete"

docker ps

管理にCLIを使う

CLIには、プラットフォームAPI用のコマンドもあります。各操作を行うには、アカウントにそのための権限が必要です。

• 操作を実行する前に、コマンドのヘルプで現在のフラグを確認してください。
• loginコマンドは、APIのベースURL、メールアドレス、パスワードを受け取ります。返されたセッショントークンは保存されます。
• 現在、login コマンドは、成功時のログにセッショントークンを表示します。この出力は他の人に見せないでください。

コマンドグループ: accounts, posts, apps, emojis, feeds, reports, rules, settings。

./wlycli --help

./wlycli deployment --help

./wlycli login --help

./wlycli settings --help

更新と復旧

デフォルトでは、デプロイは毎日、安定版の更新を確認します。サーバー管理者は、管理画面でリリースを管理できます。

• デプロイ用ファイルは有効なままで、一部のコンテナーだけが失敗している場合は、クイックスタートの案内どおり restart を実行します。restart はコンテナーを作り直します。
• プロジェクトのディレクトリやコンテナーが残っている間は、create をもう一度実行することはできません。
• 強制削除のオプションは、デプロイ用ファイルと同梱のデータベースを削除します。復旧のための手順ではなく、データも残りません。
• deploy-server スキルは、まだ deployment update という名前を使っています。現在の CLI では、代わりに deployment auto-update を使います。手作業でメンテナンスする前に、最新の CLI ヘルプを確認してください。

./wlycli deploy restart -d example.com

AIアシスタントでデプロイする

お使いのAIアシスタントが SKILL.md パッケージに対応しているなら、公式の deploy-server スキルをダウンロードしてください。DigitalOcean へのデプロイを案内します。

今のところ、このスキルが対応しているのは DigitalOcean だけです。CLI のクイックスタートは、ほかのクラウドや自分の Linux ホストでも使えます。

パッケージにはSKILL.md、agents/openai.yaml、references/digitalocean.mdが入っています。どちらのダウンロードも、同じファイルです。