Terraform Provider F5xc

🚀 セルフホスト型GitHub Actionsランナー（コンテナ化）

すべての依存関係が事前にインストールされたDockerコンテナ内でGitHub Actionsランナーを実行します。

✨ 主な機能

• GitHub Actions Runner 2.321.0
• Go 1.23.3
• Terraform 1.9.8
• GitHub CLI (gh)
• curl, jq, git

🚀 クイックスタート

1. 環境の設定

cd .github-runner-docker
cp .env.example .env

.env ファイルを編集して、以下の値を設定します。

• GITHUB_REPOSITORY - あなたのリポジトリ（例: owner/repo）
• GITHUB_TOKEN - repo スコープを持つパーソナルアクセストークン
• F5XC_API_URL - F5 XC APIのURL
• F5XC_API_TOKEN - F5 XC APIトークン

2. ビルドと起動

docker-compose up -d --build

3. ログの確認

docker-compose logs -f

4. ランナーの停止

docker-compose down

ランナーは正常にシャットダウンすると、自動的にGitHubから登録解除されます。

📚 ドキュメント

GitHubトークンの取得方法

1. GitHub設定 → トークン にアクセスします。
2. 新しいトークン（クラシック）を生成します。
3. スコープとして repo（プライベートリポジトリの完全な制御）を選択します。
4. トークンをコピーして保存します。

F5 XC APIトークンの取得方法

1. F5 XCコンソールにログインします。
2. 管理 → パーソナル管理 → 資格情報に移動します。
3. 資格情報を追加 → APIトークンを選択します。
4. トークンをコピーして保存します。

アーキテクチャサポート

コンテナは amd64 と arm64 の両方のアーキテクチャをサポートしています。Dockerはビルド時に自動的に正しいバイナリを選択します。

リソース要件

• CPU: 2コアが推奨
• メモリ: 4GBが推奨
• ディスク: コンテナと作業ディレクトリに10GB必要

トラブルシューティング

ランナーが登録されない場合

1. GITHUB_TOKEN が repo スコープを持っていることを確認します。
2. リポジトリに対する管理者アクセス権があることを確認します。
3. ログを確認します: docker-compose logs

ツールが不足しているためにテストが失敗する場合

コンテナにはGo、Terraform、および一般的なツールが含まれています。ツールが不足している場合は以下の手順を実行します。

1. Dockerfileにツールを追加します。
2. 再ビルドします: docker-compose up -d --build

ランナーがオフラインに見える場合

1. コンテナが実行中であることを確認します: docker ps
2. エラーログを確認します: docker-compose logs
3. 再起動します: docker-compose restart

高度な設定

カスタムラベル

RUNNER_LABELS=self-hosted,Linux,X64,production

複数のランナー

スケーリングするために、複数の .env ファイルとコンポーズファイルを作成します。

# runner1.env, runner2.env など
docker-compose -f docker-compose.yml --env-file runner1.env up -d

永続的なキャッシュ

作業ディレクトリはDockerボリューム（f5xc-runner-work）に保持され、実行間でGoモジュールとビルドアーティファクトをキャッシュします。