composer-lock-updater
Run composer-lock-updater in your CI system for bot-powered composer.lock pull requests., (*1)
, (*2)
When you run clu, it:, (*3)
- Clones a given git repository to a working
/tmp/ directory.
- Runs
composer update within the working directory.
- Submits a pull request if changes are detected to a tracked
composer.lock file.
Et voila! Now your dependencies are no longer six months out of date., (*4)
composer-lock-updater is different than dependabot in that it bundles all of your updates into one pull request, instead of creating separate pull requests for each dependency., (*5)
Installing | Using | Integrate with Travis CI, (*6)
Installing
composer-lock-updater is a PHP library that can be installed with Composer:, (*7)
composer global require danielbachhuber/composer-lock-updater
composer-lock-updater depends on composer and git being available on the system. For use with GitHub, also install the official hub CLI tool. For use with GitLab, you can use the unofficial lab CLI tool that emulates hub., (*8)
Both hub and lab will need to be authenticated with their respective services in order to create the pull/merge requests., (*9)
Support for other providers
Copy clu-config.dist.json to $COMPOSER_HOME/clu-config.json to add support for your git repository provider, or to make adjustments to the pull request commands. For example, to add support for a Bitbucket-Pantheon project using Terminus Bitbucket Plugin, create the following clu-config.json:, (*10)
{
"providers": {
"terminus": {
"provider": "terminus",
"exec": ["terminus"],
"pr_create": "terminus pr-create --title=\"Update Composer dependencies\" --description %s",
"pr_list": "terminus pr-list",
"pr_close": "terminus pr-close %d -y",
"title_pattern": "%(\\d+)\\s+Update Composer dependencies\\s+clu\\-([0-9-]*)%"
}
}
}
Using
Run composer-lock-updater within an existing GitHub repository with:, (*11)
clu
composer-lock-updater defaults to using git config --get remote.origin.url. If you'd like to specify a different value, either pass the repository URL as the first positional argument or define a CLU_GIT_URL environment variable., (*12)
To use composer-lock-updater with a GitLab repository, use:, (*13)
clu --provider=gitlab
composer-lock-updater also supports the following environment variables to modify its behavior:, (*14)
-
CLU_COMPOSER_INSTALL_ARGS: Arguments passed to composer install; defaults to --no-dev --no-interaction.
-
CLU_COMPOSER_UPDATE_ARGS: Arguments passed to composer update; defaults to --no-progress --no-dev --no-interaction.
-
CLU_GIT_NAME: Name used for Git commits; defaults to 'composer-lock-update'.
-
CLU_GIT_EMAIL: Email used for Git commits; defaults to 'composer-lock-update@localhost'.
Integrate with Travis CI
This wouldn't be very useful if it didn't run automatically for you., (*15)
To configure composer-lock-updater to run on Travis master branch builds, add the following to your .travis.yml file:, (*16)
after_script:
- |
###
# Only run on one job of a master branch build
###
if [ -z "$CLU_RUN" ] || [ "$TRAVIS_BRANCH" != master ] ; then
echo "composer.lock update disabled for this build"
return
fi
###
# Install composer-lock-updater
###
export PATH="$HOME/.composer/vendor/bin:$PATH"
composer global require danielbachhuber/composer-lock-updater
###
# Install hub for creating GitHub pull requests
#
# You could also replace this with lab to create GitLab merge requests.
###
wget -O hub.tgz https://github.com/github/hub/releases/download/v2.2.9/hub-linux-amd64-2.2.9.tgz
tar -zxvf hub.tgz
export PATH=$PATH:$PWD/hub-linux-amd64-2.2.9/bin/
###
# Optional: install Sensio Labs security checker to include security advisories in PR comments
###
mkdir -p $HOME/bin
wget -O $HOME/bin/security-checker.phar http://get.sensiolabs.org/security-checker.phar
chmod +x $HOME/bin/security-checker.phar
###
# Run composer-lock-updater
###
clu $CLU_REPO_URL
To grant commit and pull request access to the Travis build, define these private environment variables in the Travis control panel:, (*17)
GITHUB_TOKEN=<personal-oauth-token>
CLU_REPO_URL=https://<personal-oauth-token>:x-oauth-basic@github.com/<org>/<repo>.git
Make sure to replace <personal-oauth-token>, <org> and <repo> with the appropriate values., (*18)
Lastly, because of the CLU_RUN environment variable, composer-lock-updater is disabled by default. Enable it for one job per build by modifying your environment matrix:, (*19)
matrix:
include:
- php: 7.1
env: WP_VERSION=latest PHP_APCU=enabled CLU_RUN=1
- php: 7.0
env: WP_VERSION=latest PHP_APCU=enabled
- php: 5.6
env: WP_VERSION=latest PHP_APCU=enabled
Because composer-lock-updater is running on the after_script step, make sure to verify it's working correctly, because it won't fail your build if misconfigured., (*20)
Wallogit.com
