wcm_io_devops.jenkins_facts

この役割は、現在のJenkinsインスタンスに関する情報を提供します:

• Jenkins-Crumb（CSRF保護されたリクエストに使用可能）
• インストールされているプラグイン
• アップデートセンターの状態

これらの情報は、JenkinsインスタンスでGroovyスクリプトを実行することで取得されます。詳細は以下をご覧ください:
gather_jenkins_facts.groovy

要件

この役割はAnsible 2.7以上が必要です。コントロールホストには、pipパッケージのjmespathが必要です。

役割の変数

使用可能な変数は以下に示されており、デフォルト値も記載されています:

jenkins_facts_admin_username: admin

Jenkinsの管理者ユーザー名。

jenkins_facts_admin_password: admin

Jenkinsの管理者パスワード。

jenkins_facts_jenkins_hostname: localhost

Jenkinsインスタンスのホスト名。

jenkins_facts_jenkins_port: 8080

JenkinsインスタンスのHTTPポート。

jenkins_facts_jenkins_url_prefix: ""

JenkinsインスタンスのURLプレフィックス（例: Tomcatで実行する場合）。

jenkins_facts_jenkins_base_url: "http://{{ jenkins_facts_jenkins_hostname }}:{{ jenkins_facts_jenkins_port }}{{ jenkins_facts_jenkins_url_prefix }}"

JenkinsインスタンスのベースURL。

jenkins_facts_script_timeout: 30

jenkins_scriptを使用した情報収集のタイムアウト。

jenkins_facts_uri_timeout: 30

URIコマンドのタイムアウト。

依存関係

この役割には厳密な依存関係はありませんが、

• jenkins-plugins

役割と密接に連携します。

ファクト

jenkins_facts役割によって提供される情報は以下の通りです:

• {{ jenkins_facts_updatecenter }}
  • 最後の更新のタイムスタンプ updateTimestamp
  • 最後の更新からの秒数 updateAgeSeconds
  • 現在のタイムスタンプ currentTimestamp
• {{ jenkins_facts_plugins_installed }}: インストールされている全プラグインのリスト バージョン、ステータス、プラグインの更新の有無を含む
• {{ jenkins_facts_plugins_failed }}: 読み込みに失敗したプラグインのリストとその原因
• {{ jenkins_facts_csrf_enabled }}: CSRF保護が有効か無効かの状態（新しいJenkinsインスタンスではCSRF保護が必須）
• {{ jenkins_facts_csrf_crumb }}: 新しい/現在のCSRF用Jenkins-Crumbトークン
• {{ jenkins_facts_cookie }}: 新しい/現在のCookieトークン

例プレイブック

このプレイブックは、Jenkinsインスタンスから情報を収集し、出力します:

- hosts: jenkins
  roles:
    - { role: wcm_io_devops.jenkins_facts }

ライセンス

Apache 2.0