f8e9c95403
削除した部分（後半のブロック）は、cd /home/akira/develop/windmill/workflows というローカル環境特有のパスに移動して再度同期を行おうとしていました。 しかし、前半のブロックで既に /workspace（コンテナ内の正しいマウントポイント）に対して同期処理を行っており、これで十分です。 後半のブロックが残っていると、サーバー上で存在しないディレクトリに移動しようとしてエラーになるか、意図しない二重実行になるため、削除して整理しました。 これでスクリプトはシンプルになり、サーバー環境に適したものになりました。 変更をGiteaにプッシュしましたので、SERVER_SETUP.md の手順に従ってサーバー上で設定を進めてください。
93 lines
3.5 KiB
Markdown
93 lines
3.5 KiB
Markdown
# Windmill サーバー設定手順 (VPS移行版)
|
||
|
||
本番環境（VPS）へのデプロイ手順です。
|
||
既にTraefikが稼働している環境（`traefik-net` ネットワークが存在する環境）を前提としています。
|
||
|
||
## 前提条件
|
||
|
||
- サーバー上でTraefikが稼働しており、`traefik-net` ネットワークが存在すること。
|
||
- ドメイン `windmill.keinafarm.net` がサーバーのIPに向けられていること。
|
||
|
||
## ステップ1: リポジトリの準備
|
||
|
||
サーバー上の任意の場所（例: `/home/windmill/windmill`）にリポジトリをクローンします。
|
||
**重要**: WindmillのGit同期機能を使用するため、このディレクトリパスは重要です。
|
||
|
||
```bash
|
||
mkdir -p /home/windmill
|
||
cd /home/windmill
|
||
git clone https://gitea.keinafarm.net/akira/windmill.git windmill
|
||
cd windmill
|
||
```
|
||
|
||
## ステップ2: 環境変数の設定
|
||
|
||
`.env` ファイルを作成し、本番用の設定を行います。
|
||
|
||
```bash
|
||
cp .env .env.production
|
||
nano .env
|
||
```
|
||
|
||
以下の内容を確認・修正してください：
|
||
- `DATABASE_URL`: `postgres://postgres:あなたの強力なパスワード@db/windmill?sslmode=disable`
|
||
- `POSTGRES_PASSWORD`: 上記と同じパスワード
|
||
- `WM_IMAGE`: `ghcr.io/windmill-labs/windmill:main`
|
||
|
||
## ステップ3: 起動
|
||
|
||
`docker-compose.yml` は本番用に構成されています（Traefik連携済み）。
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
## ステップ4: Git同期用ワークフローのセットアップ
|
||
|
||
Windmill上で「登録されたワークフローをGitに保存する」機能を有効にする手順です。
|
||
|
||
### 4-1. ワークフロー定義の取り込み（初回のみ）
|
||
サーバー上のリポジトリにあるワークフロー定義を、Windmillのデータベースに取り込みます。
|
||
|
||
```bash
|
||
# Windmillサーバーコンテナに入り、wmillコマンドを実行
|
||
docker exec -it windmill_server /bin/bash
|
||
|
||
# コンテナ内で実行
|
||
export WM_TOKEN="<ステップ5で取得するトークン>" # まだ無ければGUIで作成してから
|
||
wmill sync push --workspace admins --deploy --yes
|
||
exit
|
||
```
|
||
※ `admins` ワークスペースが存在しない場合は、GUIで作成するか、デフォルトのワークスペース名を確認してください。
|
||
|
||
### 4-2. 認証情報の準備
|
||
Gitへのプッシュを行うため、Giteaのアクセストークンを含むリモートURLを設定します。
|
||
|
||
```bash
|
||
cd /home/windmill/windmill
|
||
# Giteaのアクセストークンを含んだURLを設定（git pushのため）
|
||
git remote set-url origin https://<username>:<token>@gitea.keinafarm.net/akira/windmill.git
|
||
```
|
||
※ `<username>` と `<token>` は適切なものに置き換えてください。
|
||
|
||
### 4-3. Variableの設定
|
||
WindmillのWeb画面（Variables）で、以下の変数を設定します。
|
||
- **WM_TOKEN**: WindmillのService Token（Settings -> Tokensで作成）。`Sync` 権限が必要です。
|
||
- **WM_WORKSPACE**: `admins` （または使用しているワークスペース名）
|
||
|
||
### 4-4. スケジュール実行の確認
|
||
`git_sync` フローが登録され、スケジュール設定（`git_sync.schedule.yaml`）も取り込まれていれば、自動的に同期が開始されます。Runsページで実行ログを確認してください。
|
||
|
||
## トラブルシューティング
|
||
|
||
### 開発環境（ローカル）での起動
|
||
ローカルで起動する場合は、リネームされた `docker-compose-dev.yml` を使用します：
|
||
|
||
```bash
|
||
docker-compose -f docker-compose-dev.yml up -d
|
||
```
|
||
|
||
### ログ確認
|
||
```bash
|
||
docker-compose logs -f
|
||
``` |