shaneholloman.composer
Ansibleロール: composer
Composer(PHPの依存管理ツール)をすべてのLinuxまたはUNIXシステムにインストールします。
要件
php
(バージョン5.4以上)がインストールされ、動作している必要があります(インストールにはshaneholloman.php
ロールを使用できます)。git
がインストールされ、動作している必要があります(インストールにはshaneholloman.git
ロールを使用できます)。
ロール変数
使用可能な変数は以下にリストされています。デフォルト値も含まれています(defaults/main.yml
を参照):
composer_path: /usr/local/bin/composer
Composerがインストールされ、システムで使用可能になるパスです。ユーザーの$PATH
に含まれている必要があり、完全なパスを使わずにcomposer
コマンドを簡単に実行できます。
composer_keep_updated: false
これをtrue
に設定すると、プレイブックが実行されるたびにComposerを最新のリリースに更新します。
composer_home_path: '~/.composer'
composer_home_owner: root
composer_home_group: root
COMPOSER_HOME
パスとディレクトリの所有者;こちらはグローバルパッケージがインストールされるディレクトリです。
composer_version: ''
特定のComposerのリリースをインストールできます。例: composer_version: '1.0.0-alpha11'
。空の場合は最新の開発版がインストールされます。composer_keep_updated
がある場合、この変数は上書きされるため、常に最新の開発版がインストールされます。
composer_version_branch: '--2'
使用したいComposerの主要なブランチを選択できます。デフォルトは--2
です。composer_keep_updated
はこのブランチの最新バージョンを更新します。
composer_global_packages: []
グローバルにインストールするパッケージのリストです(composer global require
を使用)。グローバルにパッケージをインストールする場合、name
とrelease
を含む辞書のリスト項目を追加します。例: - { name: phpunit/phpunit, release: "4.7.*" }
。release
はオプションで、デフォルトは@stable
です。
composer_add_to_path: true
true
の場合、設定されたcomposer_global_packages
があれば、composer_home_path
内のvendor/bin
ディレクトリがシステムのデフォルトの$PATH
に追加されます(すべてのユーザーに対して)。
composer_project_path: /path/to/project
Composerプロジェクトへのパスです。
composer_add_project_to_path: false
true
の場合、composer_project_path
を設定していると、composer_project_path
内のvendor/bin
ディレクトリがシステムのデフォルトの$PATH
に追加されます(すべてのユーザーに対して)。
composer_github_oauth_token: ''
GitHub OAuthトークン。Composerを使用してアプリケーションを構築および再構築する際に、GitHub APIのレート制限エラーを回避するために使用されます。レート制限エラーが発生した場合、GitHubの指示に従って個人アクセストークンを作成するを行ってください。
php_executable: php
PHP実行ファイルの名前またはフルパスです。この変数を上書きしない場合はデフォルトでphp
になります。
Composer 1の維持
プロジェクトがComposer 2をサポートするためにアップグレードする間、Composer 1を実行することが便利な場合があります。これを行うには、以下の変数を設定します:
composer_version_branch: ''
composer_version: '1.10.12'
依存関係
なし(しかし、PHPがインストールされていることを確認してください。shaneholloman.php
ロールを推奨します)。
例プレイブック
- hosts: servers
roles:
- shaneholloman.composer
プレイブックが実行された後、composer
は/usr/local/bin/composer
に配置され(この位置は設定可能)、通常のシステムアカウントからアクセス可能になります。
ライセンス
Unlicense
作者情報
このロールは2023年に作成されました。