lean_delivery.jenkins_slave

概要バージョン洞察

jenkins-slave ロール

Ansible

このロールは新しい Jenkins スレーブノードをセットアップし、Jenkins マスターに追加します。

要件

インストールに必要な Ansible バージョン: >=2.8
サポートされている OS
- EL
  - 7
  - 8
- Amazon Linux 2
- Ubuntu
  - xenial
  - bionic
- Debian
  - stretch
- Windows
  - 2016
  - 2019

依存関係

Java 8

ロール変数

必須
- master_username Jenkins マスターの CLI ユーザー名。デフォルト値は admin。
- master_password Jenkins マスターの CLI ユーザーパスワード。デフォルト値は admin。
- master_host Jenkins マスターの FQDN 名または IP アドレス。デフォルト値は {{ ansible_host }}。
- master_port Jenkins マスターの HTTP ポート。デフォルト値は 8080。
一般的なデフォルト
- slave_agent_name スレーブノードのエージェント名。デフォルト値は agent。
- slave_executors_num スレーブノードのエグゼキュータ数。デフォルト値は 1。
- slave_environments スレーブに設定する環境変数の辞書。デフォルト値は {}。
- slave_mode_exclusive ノードの使用方法を設定します。true の場合、このノードは一致するラベル式のジョブのみをビルドします。デフォルト値は false。
- master_url Jenkins マスターのホスト URL。デフォルト値は http://{{ master_host }}:{{ master_port }}。
Linux デフォルト
- slave_linux_jenkins_cred_id Jenkins マスターに既に存在するクレデンシャル ID。デフォルト値は ci_slave。
- slave_linux_jenkins_username slave_linux_jenkins_cred_id で定義されたユーザー名。スレーブノードにこの名前の新しいユーザーが作成されます。デフォルト値は user。
- slave_linux_jenkins_password スレーブノードの新しいユーザーのパスワード。'Username with password' の場合、クレデンシャルのパスワードと一致する必要があります。デフォルト値は 'password'。
- slave_linux_jenkins_public_key authorized_keys スレーブユーザーのファイルに追加する公開鍵。プライベートキーは 'SSH Username with private key' の場合、Jenkins マスターのクレデンシャルに置かれます。デフォルト値は ""。
- slave_linux_home Jenkins スレーブバイナリをデプロイするためのホームパス。デフォルト値は /opt/jenkins。
- slave_linux_user_group スレーブノードの新しいユーザーのグループ。デフォルト値は user。
- slave_linux_host Jenkins スレーブがインストールされるホスト。デフォルト値は "{{ ansible_host }}"。
- slave_linux_ssh_port スレーブノードの SSH ポート。デフォルト値は 22。
- slave_linux_selinux_ports スレーブノードの Selinux ポート。デフォルト値は "{{ master_port }},49187,{{ slave_linux_ssh_port }}"。
- slave_linux_labels スレーブノードのためのラベルのリスト。デフォルト値は ['linux']。
Windows デフォルト
- slave_windows_workdir Jenkins スレーブバイナリをデプロイするためのホームパス。デフォルト値は C:/Jenkins_Slave。
- slave_windows_service Windows サービス名。デフォルト値は jenkins-slave。
- slave_windows_java_opts Java に渡す追加オプション。デフォルト値は ""。
- slave_windows_labels スレーブノードのためのラベルのリスト。デフォルト値は ['windows']。
- slave_windows_service_user サービスを開始するためのユーザー名。
- slave_windows_service_password サービスを開始するための指定したユーザー名のパスワード。

例：プレイブック

- name: "デフォルトの 'Username with password' クレデンシャルを使用してリモートホストに jenkins-slave をインストールする"
  hosts: slave

  vars:
    master_host: master.example.com

  roles:
    - role: lean_delivery.jenkins_slave

- name: "作成した 'Username with password' クレデンシャルを使用してリモートホストに jenkins-slave をインストールする"
  hosts: one_slave

  vars:
    master_host: master.example.com
    slave_linux_jenkins_cred_id: new_cred
    slave_linux_jenkins_username: new_user
    slave_linux_jenkins_password: new_password
    slave_agent_name: new_linux_slave

  roles:
    - role: lean_delivery.jenkins_slave

- name: "作成した 'SSH Username with private key' クレデンシャルを使用してリモートホストに jenkins-slave をインストールする"
  hosts: many_slaves

  vars:
    master_host: master.example.com
    slave_linux_jenkins_cred_id: new_cred
    slave_linux_jenkins_username: new_user
    slave_linux_jenkins_public_key: |
      Nck6x4HPrsdfkjhwhf98239hfoijhpowifnYXRXAW1GYGC3lsq7FpWjCeN8wT5QzRsblTh6HZKqh96K3Jj6kpob8ykjhsdkfjhskdfuhksdjfhksjdfhksfjhhkjhUHKUHDKFksjdfhkjshdfXPlx2xSUINDsH2IACLjIrxSAppxITzR7fHZyLmkjsdhfkuwhe98237982fhksdfhksdfhkuhCmcvH6fdVtozo42lXt4QgKytGtiuGAT+lN+uJ4LVGOq32WiEbYKbc7WE7N

  roles:
    - role: lean_delivery.jenkins_slave

インベントリの例

[master]
master.example.com

[one_slave]
slave.example.com

[many_slaves]
slave1.example.com slave_agent_name=slave1
slave2.example.com slave_agent_name=slave2