Gogs
この記事では、Gogs用のDroneサーバをインストールする方法について説明します。サーバは、DockerHubで配布される最小限のDockerイメージとしてパッケージ化されています。
ステップ1:ダウンロード
Droneサーバは、軽量のDockerイメージとして配布されます。イメージは自己完結型であり、外部依存関係はありません。
$ docker pull drone/drone:1
ステップ2:構成
Droneサーバは、環境変数を使用して構成されます。この記事では、以下に定義する構成オプションのサブセットについて説明します。構成オプションの完全なリストについては、構成を参照してください。
- DRONE_GOGS_SERVER
必要な文字列値は、Gogsサーバーアドレスを提供します。例:https://gogs.company.com - DRONE_GIT_ALWAYS_AUTH
オプションのブール値は、パブリックリポジトリのクローンを作成するときに認証するようにDroneを構成します。 - DRONE_RPC_SECRET
必要な文字列値は、Droneの共有秘密を提供します。これは、サーバへのrpc接続を認証するために使用されます。サーバとエージェントには同じシークレット値を指定する必要があります。 - DRONE_SERVER_HOST
必要な文字列値は、外部ホスト名またはIPアドレスを提供します。 IPアドレスを使用する場合は、ポートを含めることができます。例:drone.company.com - DRONE_SERVER_PROTO
必要な文字列値は、外部プロトコルスキームを提供します。この値はhttpまたはhttpsに設定する必要があります。 sslまたはacmeを設定した場合、このフィールドのデフォルトはhttpsです。
ステップ3:サーバを起動します
サーバコンテナは、以下のコマンドで起動できます。コンテナは環境変数を介して構成されます。以下のプレースホルダー値を適切な値に置き換えることを忘れないでください。
1 docker run \
2 --volume=/var/lib/drone:/data \
3 --env=DRONE_AGENTS_ENABLED=true \
4 --env=DRONE_GOGS_SERVER=https://gogs.company.com \
5 --env=DRONE_RPC_SECRET={{DRONE_RPC_SECRET}} \
6 --env=DRONE_SERVER_HOST={{DRONE_SERVER_HOST}} \
7 --env=DRONE_SERVER_PROTO={{DRONE_SERVER_PROTO}} \
8 --publish=80:80 \
9 --publish=443:443 \
10 --restart=always \
11 --detach=true \
12 --name=drone \
13 drone/drone:1
ステップ4:ランナーをインストールする
サーバが稼働したら、ビルドパイプラインを実行するためにランナーをインストールする必要があります。詳細なインストール手順については、ランナーのインストールドキュメントを参照してください。
ステップ5:ログイン
ブラウザでサーバアドレスにアクセスすると、Droneサーバにログインできます。 Gogsのユーザー名とパスワードを使用して認証する必要があります。 Gogsはoauthをサポートしていないため、これは必須です。