ニフクラ DevOps with GitLab：Runner
RunnerをDevOpsサーバーやGitLab SaaS、その他のGitLabインスタンスに登録すれば、DevSecOpsを実践するための環境を構築できます。
Runner
| リージョンあたりの作成可能数 | 10台 |
| Runnerあたりの登録可能数 | 3 |
| ディスク容量 | 30GB（※1） |
| 登録可能なGitLabのタイプ（※2） | DevOpsサーバー、GitLab SaaS（gitlab.com）、セルフマネージドGitLabインスタンス |
| Runner登録方法 | GitLab Web画面で作成したRunnerトークンを用いたRunner登録（※3） |
| Executor | Docker |
| GitLab Runnerバージョンアップグレード | 自動更新（※4） |
| ジョブの並列実行数（※5） | 1～50 |
※1 毎日 04:00 にDockerの使用されていないリソース（イメージ・ボリューム等）の消去を行います。
※2 RunnerのグローバルIPアドレスまたはプライベートIPアドレス（DevOpsサーバーを含む、ニフクラ上リソースの場合）が、登録先のGitLabインスタンスのファイアウォールルールで許可されている必要があります。
※3 RunnerトークンはGitLab 16.0以降で作成・利用できます。
※4 毎月第4水曜日 20:00~22:00 にGitLab Runnerバージョンのアップグレードを実行します。また、緊急度の高い脆弱性に対処するための緊急アップグレードを行う場合があります。アップグレード処理中はRunnerの停止が発生します。
※5 Runnerで実行されるジョブの並列実行数です。Runner設定のグローバルセクションにおける concurrent 値として構成されます。全Runner登録にまたがって適用されます。
命名時に使用可能な文字
| 設定項目 | 長さ | 主な制約事項 | 備考 |
|---|---|---|---|
| Runner名 | 1～30 | 半角英数字、ハイフン | ハイフンは先頭と末尾に使用不可 |
| メモ | ～255 | 全半角 |
作成可能サーバータイプ
| Type-c | runner.c-small、runner.c-small2、runner.c-small4、runner.c-medium、runner.c-medium4、runner.c-medium8、runner.c-large、runner.c-large8 |
| Type-e | runner.e-small、runner.e-small2、runner.e-small4、runner.e-small8、runner.e-small16、runner.e-medium、runner.e-medium4、runner.e-medium8、runner.e-medium16、runner.e-medium24、runner.e-large、runner.e-large8、runner.e-large16、runner.e-large24、runner.e-xlarge8、runner.e-xlarge16、runner.e-xlarge24、runner.e-wlarge16、runner.e-wlarge24 |
| Type-h2 | runner.h2-small、runner.h2-small2、runner.h2-small4、runner.h2-small8、runner.h2-small16、runner.h2-medium、runner.h2-medium4、runner.h2-medium8、runner.h2-medium16、runner.h2-medium24、runner.h2-large、runner.h2-large8、runner.h2-large16、runner.h2-large24、runner.h2-xlarge8、runner.h2-xlarge16、runner.h2-xlarge24、runner.h2-wlarge16、runner.h2-wlarge24 |
Runnerのステータス
Runnerが正常稼働しているかをステータスで表示しています。
RunnerのステータスはコントロールパネルまたはGetRunner APIで確認してください。
| カテゴリー | 表示 | アイコン | 説明 |
|---|---|---|---|
| 正常 | 稼働中 |  |
Runnerは正常に稼働しています。 |
| 失敗 | エラー |  |
Runnerの各種処理に失敗しました。この状態からは削除と一部の更新処理が実行可能です。 |
| 処理中 | 作成中 |  |
Runnerを作成しています。 |
| 処理中 | 削除中 | |
Runnerを削除しています。 |
| 処理中 | 処理中 | |
Runnerの各種処理(設定変更)を実行中です。 |
| 処理中 | 登録中 | |
Runnerを登録しています。 |
| 処理中 | 登録解除中 | |
Runnerを登録解除しています。 |
| 処理中 | アップグレード中 | |
Runnerをアップグレードしています。アップグレード中はRunnerの停止が発生します。 |
Runnerのステータス詳細
エラーには更に詳細なステータスがあります。
ステータスに応じて一部の操作が可能です。対処を実施しても解決しない場合は問い合わせ窓口より問い合わせしてください。
Runnerのステータス詳細に表示される文字列およびアイコンは以下となります。
ユーザーにて一次対処が可能なエラー
対処を実施しても解決しなければ、問い合わせ窓口より問い合わせしてください。カテゴリー 表示 アイコン ステータス名 説明 失敗 エラー FAILED_RUNNER_CREATE Runnerの作成に失敗しました。この状態からはインスタンスの削除のみ可能です。 失敗 エラー FAILED_RUNNER_DELETE Runnerの削除に失敗しました。この状態からはインスタンスの削除のみ可能です。 失敗 エラー FAILED_RUNNER_REGISTER Runnerの登録に失敗しました。GitLab URLやトークンなど各パラメーターで正しい値が設定されていることを確認し、登録を再実行してください。
登録先GitLabインスタンス側のファイアウォール等のアクセス制御でRunnerのIPアドレスが許可されているかを確認してください。失敗 エラー FAILED_RUNNER_UNREGISTER Runnerの登録解除に失敗しました。再度、登録解除実施してください。
登録先GitLabインスタンス側のファイアウォール等のアクセス制御でRunnerのIPアドレスが許可されているかを確認してください。失敗 エラー FAILED_RUNNER_UPDATEPARAM Runner登録のパラメーター更新に失敗しました。再度パラメーターが正しいか確認し、更新してください。 問い合わせが必要なエラー
以下のエラーは弊社にて対処が必要です、問い合わせ窓口より問い合わせしてください。カテゴリー 表示 アイコン ステータス名 説明 失敗 エラー FAILED_RUNNER_UPGRADE Runnerのアップグレードに失敗しました。データの不整合が発生している可能性があるため問い合わせしてください。 失敗 エラー FAILED_RUNNER_UPDATESPEC Runnerのサーバータイプ変更に失敗しました。データの不整合が発生している可能性があるため問い合わせしてください。 失敗 エラー FAILED_RUNNER_SYSTEM Runnerが異常な状態になりました。問い合わせしてください。
注意事項
- 毎月、定期的なアップグレードが行われます。詳細は アップグレード をご確認ください。
- 毎日、定期的なディスク容量の解放が行われます。使用されていないDockerイメージやボリューム等が削除されます。実行中のジョブに影響はありません。
- Runnerの削除時には紐づくRunner登録の登録解除が試みられます。ただし何らかのエラーにより登録解除ができない場合にはGitLabインスタンス側にRunner登録が残る可能性があります。その際は、GitLabインスタンス上で該当Runner登録を消去してください。
アンケート
サービス利用中のトラブルは、ニフクラサポート窓口にお願いします。
アンケートにご協力を
