Ansibleロール: Drush

このロールは、LinuxまたはUNIXシステム上にDrupal用のコマンドラインシェルおよびスクリプトインターフェースであるDrushをインストールします。

要件

このロールを実行する前に、システムにPHPをインストールしておく必要があります（推奨ロール: geerlingguy.php）。

グローバルなComposerのインストールには、システムにComposerがインストールされている必要があります（推奨ロール: geerlingguy.composer）。

ソースインストールを行う場合は、さらにGitとComposerもシステムにインストールする必要があります（推奨ロール: geerlingguy.git と geerlingguy.composer）。

ロール変数

利用可能な変数は以下にリストされており、デフォルト値も示されています（defaults/main.ymlを参照）。

Drush Launcher

Drush Launcherは、グローバルな$PATHに対するDrushの小さなラッパーです。

drushを使用する推奨方法ですが、Drush Launcherを使用せずにグローバルにDrushをインストールして実行したい場合もあります。以下の変数でDrush Launcherのインストールを制御します。

drush_launcher_install: true

インストーラーをインストールしたくない場合はnoに設定します。

drush_launcher_version: "0.10.1"

インストールするDrush Launcherのバージョン。これは利用可能なDrush Launcherのリリースと正確に一致する必要があります。

drush_launcher_phar_url: https://github.com/drush-ops/drush-launcher/releases/download/{{ drush_launcher_version }}/drush.phar

Drush LauncherのpharファイルをダウンロードするためのURL。

drush_launcher_path: /usr/local/bin/drush

drushがインストールされ、システムで使用できるようにするパス。ユーザーの$PATHに置くべきですので、コマンドはdrushと入力するだけで実行できます。

ComposerによるDrushのグローバルインストール

全体でdrushのフル機能を利用したい場合、このロールを利用するとComposerを通じてグローバルにDrushをインストールできます。このオプションを使用する場合は、Composerがインストールされていることを確認してください！

drush_composer_global_install: false

drushをComposerを利用してグローバルにインストールしたい場合はyesに設定し、drush_launcher_installをfalseに設定します。

drush_composer_version: "~11.0"

グローバルなDrushインストールのバージョン制約。

drush_composer_update: false

グローバルにインストールされたDrushのバージョンが最新であることを確認するために、composer update drush/drushを実行するかどうか。

drush_composer_global_bin_path: ~/.config/composer/vendor/bin
drush_composer_path: /usr/local/bin/drush

Composerがグローバルなバイナリをインストールするためのグローバルパスと、drushバイナリを配置したいパス。

注: Composerの「グローバル」インストールは、Drushがインストールされているユーザーに対してグローバルです - 例えば、rootユーザーを使ってグローバルにインストールすると、drushはrootとしてのみ正常に動作します。

ソースインストール（Git）用の変数

Composerを通じてインストールできない特別なバージョンが必要な場合、または最新のリリースが必要な場合には、ソースからDrushをインストールすることもできます。

drush_install_from_source: false

Drushのソースコードを使用してdrushをグローバルにインストールしたい場合はyesに設定し、drush_launcher_installをfalseに設定します。

drush_source_install_bin_path: /usr/local/bin/drush
drush_source_install_path: /usr/local/share/drush

Drushのインストール全体の場所（すべてのサポートファイル、及びdrush実行ファイルが含まれます）。

drush_source_install_version: "11.x"

インストールするDrushのバージョン（例: "master"は最新、"11.x"、"10.x"、"6.2.0"など）。これはブランチ、タグ、またはコミットハッシュを参照するための文字列にする必要があります。

drush_keep_updated: false
drush_force_update: false

指定されたdrush_versionのブランチの最新リビジョンでDrushをアップデートし続けるか、アップデートを強制するかどうか（例: Drushリポジトリのローカル変更を上書き）。

drush_force_composer_install: false

autoload.phpを読み込めません。依存関係を取得してこのファイルを書くにはcomposer installを実行してください。というエラーメッセージが表示される場合はこれを使用します。Drushのディレクトリ内で強制的にcomposer installを実行します。

drush_composer_cli_options: "--prefer-source --no-interaction"

これらのオプションは、Drushをインストールする際にGitHub APIのレート制限を回避するために最も安全であり、依存関係やインストール作業の際に非常に役立ちます。最初のオプションを--prefer-distに変更することで、ビルドを大幅に高速化できます。

drush_clone_depth: 1

デフォルトで全リポジトリをクローンするか（デフォルト）、より小さく早いクローンのために過去のコミット数を指定するか。

依存関係

なし。

例 Playbook

- hosts: servers
  roles:
    - geerlingguy.drush

プレイブックが実行された後、drushコマンドは通常のシステムアカウントからアクセス可能になります。

ライセンス

MIT / BSD

作者情報

このロールは2014年にJeff Geerlingによって作成されました。彼はAnsible for DevOpsの著者です。