GitLab Runner: はじめに

Stackhero GitLab Runner を GitLab.com またはセルフマネージド GitLab に接続し、最初のパイプラインを実行する

👋 Stackhero ドキュメントへようこそ！

Stackhero では、GitLab Runner cloud を簡単にご利用いただけるソリューションとしてご提供しています。GitLab CI/CD ジョブを効率的に処理できるよう設計されています。主な特長は以下の通りです：

無制限の CI/CD 分数：分単位の課金はありませんので、必要なときにいつでもパイプラインを実行できます。

複数ジョブの同時実行：複数のジョブを同時に実行し、パイプライン全体の処理速度を向上させます。

Docker executor と Docker-in-Docker サポート：コンテナイメージのビルドやプッシュを効率化します。

GitLab.com およびあらゆる セルフホスト型 GitLab インスタンスに対応。

高速な NVMe/SSD ディスクを搭載した プライベート専用 VM で、安定したビルド環境を提供します。

🇪🇺 ヨーロッパ および 🇺🇸 USA リージョンでご利用可能です。

時間を節約：最初の GitLab Runner を接続し、数分でパイプラインの実行を開始できます！

はじめに

GitLab Runner は、GitLab CI/CD ジョブを実行するエージェントです。パイプラインがトリガーされるたびに、Runner が各ジョブを取得し、クリーンな Docker コンテナ内で実行し、その結果を GitLab に報告します。

Stackhero では、Runner はプライベートで専用の仮想マシン（VM）上で動作します。従量課金や利用制限はなく、CI/CD の実行分数は無制限です。ご利用プランに応じて、Runner は同時に数十件のジョブを処理できます。

このガイドでは、Stackhero Runner を数分で GitLab に接続する手順を説明します。

ステップ 1: Stackhero で GitLab Runner を作成する

Stackhero ダッシュボードから、新しい GitLab Runner サービスを作成し、ニーズに合ったプランを選択できます。プランによって利用可能な CPU、RAM、同時実行ジョブ数（GitLab Runner の concurrent 設定、同時に実行できるジョブ数）が決まります。

Runner は約 2 分で起動します。

ステップ 2: GitLab で Runner を作成する

Runner は Runner 認証トークン を使って GitLab に接続します。このトークンは GitLab で発行し、Runner のスコープもここで決定します：

Project runner: プロジェクトを開き、Settings > CI/CD > Runners > New project runner へ進みます。
Group runner: グループを開き、Settings > CI/CD > Runners > New group runner へ進みます。
Instance runner（セルフマネージド GitLab のみ）: Admin area > CI/CD > Runners > New instance runner へ進みます。

Runner 作成時には、以下の設定が可能です：

タグ（例：docker や stackhero）を追加して、ジョブからこの Runner をターゲットにできます。
タグなしジョブの実行を許可することで、すべてのジョブをこの Runner で処理できます。

GitLab からは glrt- で始まるRunner 認証トークンが発行されます。このトークンは Runner の認証に使用されるため、安全に保管してください。

旧来の registration token フローは非推奨となっています。上記の手順で Runner 作成時に発行される Runner 認証トークン（glrt-...）をご利用ください。

ステップ 3: Runner を接続する

Stackhero ダッシュボードに戻り、GitLab Runner サービスの設定画面を開き、以下の情報を入力してください：

GitLab URL：GitLab.com を利用する場合は https://gitlab.com、セルフマネージド GitLab の場合はそのインスタンスの URL（例：GitLab を Stackhero 上で運用している場合は https://git.your-company.com など）。
ステップ 2 で取得した Runner 認証トークン（glrt-...）。
許可したい 同時実行ジョブ数。

設定を保存すると、Runner は自動的に GitLab に接続され、作成した Runners ページ上でオンラインとして表示されます。

ステップ 4: 最初のパイプラインを実行する

まず、リポジトリのルートに .gitlab-ci.yml ファイルを追加します：

stages:
  - build
  - test

build:
  stage: build
  image: node:22
  script:
    - npm ci
    - npm run build

test:
  stage: test
  image: node:22
  script:
    - npm test

変更をコミットしてプッシュすると、GitLab がパイプラインを開始し、Stackhero Runner がジョブを実行します。Runner 作成時にタグを追加している場合は、以下のようにジョブでタグを指定できます：

build:
  stage: build
  tags:
    - stackhero
  image: node:22
  script:
    - npm ci
    - npm run build

これで完了です。パイプラインは専用 Runner 上で、ビルド分数無制限で実行されます。

次のステップ

パイプラインから Docker イメージのビルドやプッシュを行いたい場合は、Docker イメージのビルドをご覧ください。