Skip to content

Installation.md

Latest commit

 

History

History
186 lines (129 loc) · 4.86 KB

Installation.md

File metadata and controls

186 lines (129 loc) · 4.86 KB

Installation

リリースバイナリを使う（推奨）

v1.6.0 以降、GitHubリリース にビルド済みバイナリを添付しています。 Go環境不要でインストールできます。

# 例: Linux AMD64
curl -LO https://github.com/Liplus-Project/dipper_ai/releases/latest/download/dipper_ai_linux_amd64.tar.gz
tar -xzf dipper_ai_linux_amd64.tar.gz
sudo mv dipper_ai /usr/bin/dipper_ai

対応プラットフォーム: linux/amd64, linux/arm64, darwin/amd64, darwin/arm64, windows/amd64, windows/arm64

バイナリを配置したあとはリポジトリをクローンして scripts/install.sh を実行してください（systemdの設定が必要なため）。

git clone https://github.com/Liplus-Project/dipper_ai.git
cd dipper_ai
sudo bash scripts/install.sh

go install を使う

Go環境がある場合:

go install github.com/Liplus-Project/dipper_ai/cmd/dipper_ai@latest

必要環境

項目 要件
OS AlmaLinux 9 / 10（他の systemd Linux でも動作可能）
Go 1.23 以上（ビルド時のみ）
git リポジトリのクローンに必要
権限 インストールスクリプトは root 必要

依存パッケージのインストール（AlmaLinux）

# git
sudo dnf install -y git

# Go 1.23+（dnf のバージョンが古い場合は公式バイナリを使用）
sudo dnf install -y golang
go version  # 1.23 未満の場合は以下の手順で公式バイナリを導入

# Go 公式バイナリ（dnf で 1.23+ が入らない場合）
curl -LO https://go.dev/dl/go1.23.6.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.23.6.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/go.sh
source /etc/profile.d/go.sh
go version

ビルド

git clone https://github.com/Liplus-Project/dipper_ai.git
cd dipper_ai
go build -o dipper_ai ./cmd/dipper_ai

クロスコンパイル例（Linux AMD64 向け）:

GOOS=linux GOARCH=amd64 go build -o dipper_ai ./cmd/dipper_ai

インストール

scripts/install.sh を root で実行します。 以下のファイルが配置され、systemd タイマーが有効化されます。

sudo bash scripts/install.sh

配置先

ファイル 配置先
dipper_ai バイナリ /usr/bin/dipper_ai
設定サンプル /etc/dipper_ai/user.conf.example
systemd サービス /etc/systemd/system/dipper_ai.service
systemd タイマー /etc/systemd/system/dipper_ai.timer
状態ファイル /etc/dipper_ai/state/（実行時に自動生成）

インストール後の手順

# 設定ファイルを作成して編集
sudo cp /etc/dipper_ai/user.conf.example /etc/dipper_ai/user.conf
sudo vi /etc/dipper_ai/user.conf

# タイマーの状態確認
systemctl status dipper_ai.timer

# 手動で update を実行してテスト
sudo dipper_ai update

アップデート

新しいバージョンが出たときはリポジトリのディレクトリで以下を実行するだけです。

cd dipper_ai
git pull
go build -o dipper_ai ./cmd/dipper_ai
sudo bash scripts/install.sh

4 ステップの意味:

ステップ 内容
git pull 最新のソースコードを取得
go build ... バイナリを再ビルド
sudo bash scripts/install.sh バイナリと systemd unit を上書きインストール・タイマー再起動

Note: 設定ファイル (/etc/dipper_ai/user.conf) はインストールスクリプトで上書きされません。設定は引き継がれます。

アンインストール

sudo bash scripts/uninstall.sh

サービス・タイマーの停止と無効化、バイナリの削除を行います。 設定ファイル (/etc/dipper_ai/) は保持されます。手動で削除してください。

設定ファイルのパス

デフォルトは /etc/dipper_ai/user.conf ですが、環境変数 DIPPER_AI_CONFIG で上書きできます。

DIPPER_AI_CONFIG=/path/to/custom.conf dipper_ai update

テスト実行

go test ./...

全パッケージのユニットテスト・受け入れテストが実行されます（外部 API 接続不要）。

リリース手順（メンテナ向け）

v プレフィックスのタグをプッシュすると goreleaser が自動起動し、全プラットフォームのバイナリをビルドしてGitHubリリースに添付します。

git tag vX.X.X
git push origin vX.X.X

バージョニング規則:

種別 例 内容
patch v1.6.1 バグ修正・設定変更
minor v1.7.0 新機能・動作変更
major v2.0.0 破壊的変更