このページは英語のページを機械翻訳したものです。内容は英語のページが正です。 英語のページを読む
Docker Compose でデプロイする
Docker Compose を使って 1 台のマシンで my を動かす方法を説明します。サーバーのプロセスが 1 つで、データベースは SQLite、メディアのファイルは名前付きボリュームに置く、いちばん小さな構成です。PostgreSQL、オブジェクトストレージ、TLS は、あとから重ねるファイルで追加します(Docker Compose のファイル)。
Docker と Docker Compose v2 が必要です。
サーバーを起動する
Section titled “サーバーを起動する”Compose のファイルは、ソースの deploy/docker にあります。イメージと合うように、動かすリリースのタグから取得してください。
git clone --depth 1 --branch v0.1.0 https://github.com/mycroblog/my.gitcd my/deploy/dockercp example.env .env# Set MY_VERSION in .env to the same version, such as 0.1.0mkdir -m 700 secrets(umask 022; openssl rand -base64 32 > secrets/kek) # the key encryption key: back it up apart from the databasedocker compose up -d- Compose は
MY_VERSIONのイメージghcr.io/mycroblog/myを取得します。latestタグはないので、バージョンを指定する必要があります。リリースによっては、黙って更新すると飛ばされてしまう手順が必要になることがあるためです(イメージのタグ)。代わりにチェックアウトしたソースからイメージをビルドするには、上書きのファイルを加えます:docker compose -f compose.yaml -f compose.build.yaml up -d --build。 schemaサービスはサーバーのイメージのmy schema applyを実行し、名前付きボリュームにあるデータベースをそのリリースのスキーマにしてから終了します。サーバー(role=all)は、それが成功してから起動します。スキーマはupのたびに適用されるので、アップグレードのあとも同じ方法でサーバーを起動できます。- サーバーは
127.0.0.1:8080で待ち受けます(ポートは.envのMY_HTTP_PORTです)。curl localhost:8080/readyzが{"status":"ok"}を返せば準備ができています。 - 鍵暗号化鍵(KEK)は、環境変数ではなく、
secrets/kekから Docker のシークレット/run/secrets/my_kekとしてサーバーに渡ります(鍵暗号化鍵の管理)。 - 設定リファレンスにあるそのほかの設定は、すべて
.envで設定します。テンプレートにそれぞれの説明があります。
管理者を作る
Section titled “管理者を作る”管理者を作り、WebFinger でそのアカウントを調べて、アクターを取得します。パスワードは標準入力の 1 行目から読み込まれます。
docker compose exec -T my my admin create -username alice -email alice@example.com < password.txtcurl 'http://localhost:8080/.well-known/webfinger?resource=acct:alice@localhost:8080'curl -H 'Accept: application/activity+json' http://localhost:8080/ap/actors/<the UUID of the self link from WebFinger>ブラウザーからログインする
Section titled “ブラウザーからログインする”example.env にある MY_HOST=localhost:8080 と MY_WEB_ORIGIN=http://localhost:8080 の組み合わせでは、ログイン、クライアント API、メディアが http://localhost:8080 の素の HTTP で動きます(ActivityPub の ID は https://localhost:8080/... のままです)。MY_HTTP_PORT を変えた場合は、MY_HOST と MY_WEB_ORIGIN のポートもそれに合わせて変えてください。
- ブラウザーで
http://localhost:8080/loginを開きます(または Web クライアントの上部のバーで ログイン を押します)。サーバーのログイン画面が開きます。 - ログイン画面で、上で作った管理者のメールアドレスとパスワードを入力します。
- Web クライアントのホームタイムラインに戻ります。
- ログインの Cookie は
Secureです。Chrome と Firefox はhttp://localhostでもこれを受け入れますが、Safari(WebKit)は受け入れません。ローカルでは Chrome か Firefox を使ってください。 - 投稿の本文にあるハッシュタグとメンションのリンクは、連合で使う URL なので
https://になります。
.envのMY_HOSTを実際のドメインにし、MY_WEB_ORIGINを削除して(既定値はhttps://{MY_HOST}です)、サーバーの前段で TLS を終端してください。そのためにはレイヤーcompose.caddy.yamlが Caddy を動かします(Docker Compose のファイル)。サーバー自身に HTTPS を提供させることもできます(サーバー自身が HTTPS を提供する)。MY_HOSTは最初の起動時にデータベースに保存され、あとから変えることはできません。- 自分で用意したリバースプロキシの後ろに置く場合は、
.envにMY_TRUSTED_PROXIESを設定してください。そうすると、ログインのレート制限などがプロキシではなくクライアントの IP アドレスごとにかかります(trusted_proxies)。 - サーバーを利用者に公開する前に、本番運用前のチェックリストを確認してください。
docker compose downでスタックが止まります。down -vはデータのボリュームも削除します。
LLM とコーディングエージェント向け:llms.txt,llms-full.txt, llms-small.txt