git and rsync are required on the server that's running the script
(server machine).
Optionally, tar is required for backup functionality (BACKUP_DIR option).
Optionally, composer is required for composer functionality (USE_COMPOSER
option).
The system user running PHP (e.g. www-data) needs to have the necessary
access permissions for the TMP_DIR and TARGET_DIR locations on
the server machine.
If the Git repository you wish to deploy is private, the system user running PHP
also needs to have the right SSH keys to access the remote repository.
Usage
Configure the script and put it somewhere that's accessible from the
Internet. The preferred way to configure it is to use deploy-config.php file.
Rename deploy-config.example.php to deploy-config.php and edit the
configuration options there. That way, you won't have to edit the configuration
again if you download the new version of deploy.php.
Configure your git repository to call this script when the code is updated.
The instructions for GitHub and Bitbucket are below.
GitHub
(This step is only needed for private repositories) Go to
https://github.com/USERNAME/REPOSITORY/settings/keys and add your server
SSH key.
Go to https://github.com/USERNAME/REPOSITORY/settings/hooks.
Click Add webhook in the Webhooks panel.
Enter the Payload URL for your deployment script e.g. http://example.com/deploy.php?sat=YourSecretAccessTokenFromDeployFile.
Optional Choose which events should trigger the deployment.
Make sure that the Active checkbox is checked.
Click Add webhook.
Bitbucket
(This step is only needed for private repositories) Go to
https://bitbucket.org/USERNAME/REPOSITORY/admin/deploy-keys and add your
server SSH key.
Go to https://bitbucket.org/USERNAME/REPOSITORY/admin/services.
Add POST service.
Enter the URL to your deployment script e.g. http://example.com/deploy.php?sat=YourSecretAccessTokenFromDeployFile.
Click Save.
Generic Git
Configure the SSH keys.
Add a executable .git/hooks/post_receive script that calls the script e.g.
#!/bin/shecho"Triggering the code deployment ..."
wget -q -O /dev/null http://example.com/deploy.php?sat=YourSecretAccessTokenFromDeployFile
Done!
Next time you push the code to the repository that has a hook enabled, it's
going to trigger the deploy.php script which is going to pull the changes and
update the code on the server machine.
For more info, read the source of deploy.php.
Tips'n'Tricks
Because rsync is used for deployment, the TARGET_DIR doesn't have to be
on the same server that the script is running e.g. define('TARGET_DIR', '[email protected]:/full/path/to/target_dir/'); is going to work as long
as the user has the right SSH keys and access permissions.
You can have multiple scripts with different configurations. Simply rename
the deploy.php to something else, for example deploy_master.php and
deploy_develop.php and configure them separately. In that case, the
configuration files need to be named deploy_master-config.php and
deploy_develop-config.php respectively.
If you find this script useful, consider donating BTC to 1fLnPZkMYw1TFNEsJZCciwDAmUhDw2wit.
请发表评论