正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

FreeBSDにGitLab Runnerをインストールする

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

FreeBSDバージョンもbleeding edgeリリースとして利用できます。FAQセクションを参照してください。このセクションでは、GitLab Runnerに関する最も一般的な問題について説明しています。

GitLab Runnerのインストール

FreeBSDにGitLab Runnerをインストールして構成する手順は次のとおりです:

  1. gitlab-runnerユーザーとグループを作成します:

    sudo pw group add -n gitlab-runner
    sudo pw user add -n gitlab-runner -g gitlab-runner -s /usr/local/bin/bash
    sudo mkdir /home/gitlab-runner
    sudo chown gitlab-runner:gitlab-runner /home/gitlab-runner
  2. ご使用のシステムに対応するバイナリをダウンロードします:

    # For amd64
    sudo fetch -o /usr/local/bin/gitlab-runner https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-freebsd-amd64
    
    # For i386
    sudo fetch -o /usr/local/bin/gitlab-runner https://s3.dualstack.us-east-1.amazonaws.com/gitlab-runner-downloads/latest/binaries/gitlab-runner-freebsd-386

    Bleeding Edge - その他のタグ付きリリースをダウンロードするの説明に従って、利用可能なすべてのバージョンのバイナリをダウンロードできます。

  3. 実行権限を付与します:

    sudo chmod +x /usr/local/bin/gitlab-runner
  4. 正しい権限で空のログファイルを作成します:

    sudo touch /var/log/gitlab_runner.log && sudo chown gitlab-runner:gitlab-runner /var/log/gitlab_runner.log
  5. rc.dディレクトリが存在しない場合は作成します:

    mkdir -p /usr/local/etc/rc.d
  6. rc.d内にgitlab_runnerスクリプトを作成します:

    Bashユーザーは以下を実行できます:

    sudo bash -c 'cat > /usr/local/etc/rc.d/gitlab_runner' << "EOF"
    #!/bin/sh
    # PROVIDE: gitlab_runner
    # REQUIRE: DAEMON NETWORKING
    # BEFORE:
    # KEYWORD:
    
    . /etc/rc.subr
    
    name="gitlab_runner"
    rcvar="gitlab_runner_enable"
    
    user="gitlab-runner"
    user_home="/home/gitlab-runner"
    command="/usr/local/bin/gitlab-runner"
    command_args="run"
    pidfile="/var/run/${name}.pid"
    
    start_cmd="gitlab_runner_start"
    
    gitlab_runner_start()
    {
       export USER=${user}
       export HOME=${user_home}
       if checkyesno ${rcvar}; then
          cd ${user_home}
          /usr/sbin/daemon -u ${user} -p ${pidfile} ${command} ${command_args} > /var/log/gitlab_runner.log 2>&1
       fi
    }
    
    load_rc_config $name
    run_rc_command $1
    EOF

    bashを使用していない場合は、/usr/local/etc/rc.d/gitlab_runnerという名前のファイルを作成し、次のコンテンツを含めます:

    #!/bin/sh
    # PROVIDE: gitlab_runner
    # REQUIRE: DAEMON NETWORKING
    # BEFORE:
    # KEYWORD:
    
    . /etc/rc.subr
    
    name="gitlab_runner"
    rcvar="gitlab_runner_enable"
    
    user="gitlab-runner"
    user_home="/home/gitlab-runner"
    command="/usr/local/bin/gitlab-runner"
    command_args="run"
    pidfile="/var/run/${name}.pid"
    
    start_cmd="gitlab_runner_start"
    
    gitlab_runner_start()
    {
       export USER=${user}
       export HOME=${user_home}
       if checkyesno ${rcvar}; then
          cd ${user_home}
          /usr/sbin/daemon -u ${user} -p ${pidfile} ${command} ${command_args} > /var/log/gitlab_runner.log 2>&1
       fi
    }
    
    load_rc_config $name
    run_rc_command $1
  7. gitlab_runnerスクリプトを実行可能にします:

    sudo chmod +x /usr/local/etc/rc.d/gitlab_runner
  8. Runnerを登録する

  9. gitlab-runnerサービスを有効にして開始します:

    sudo sysrc gitlab_runner_enable=YES
    sudo service gitlab_runner start

    再起動後にgitlab-runnerサービスを起動したくない場合は、次を使用します:

    sudo service gitlab_runner onestart