continuousphp / deploy-agent
Deploy agent for continuousphp
Installs: 90
Dependents: 0
Suggesters: 0
Security: 0
Stars: 15
Watchers: 11
Forks: 9
Open Issues: 2
Type:project
Requires
- php: >=5.5.0
- ext-pdo_sqlite: *
- bushbaby/flysystem: ~1.0
- continuousphp/sdk: ~0.3
- doctrine/doctrine-orm-module: ~0.10
- reprovinci/doctrine-encrypt: ~3.0
- zendframework/zendframework: 2.5.2
Requires (Dev)
- behat/behat: ^3.0
- mikey179/vfsstream: 1.3.*@dev
- phpunit/phpunit: 4.1.*
- squizlabs/php_codesniffer: ^2.3
This package is not auto-updated.
Last update: 2024-10-26 19:41:03 UTC
README
Automated deployment agent to install on your servers.
It manages automated deployment workflows based on webhooks for your projects.
Requirements
- PHP 5.5+
- PHP mcrypt extension
- sqlite or other doctrine compatible SGBD (sqlite is currently the only one officially supported)
⚠️ the PHP sqlite extension is not installed by default.
Installation by Docker ( Container Service )
You can use our Docker image as a container service. The container is isolated from the rest of your Server and you have not to worry about server dependencies or security.
Thanks to report to Docker-Hub documentation.
Installation by Composer
- Download Composer:
curl -sS https://getcomposer.org/composer.phar -o composer.phar
- Install the Deploy Agent:
php composer.phar create-project continuousphp/deploy-agent
- Start using the agent:
cd deploy-agent && ./agent
HTTP server config
To setup apache, setup a virtual host that points to the public/ directory of the project and you should be ready to go! It should be something similar to:
<VirtualHost *>
DocumentRoot /path/to/deploy-agent/public
<Directory /path/to/deploy-agent/public>
DirectoryIndex index.php
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
Also enable apache mod rewrite in order to support webhook routes
a2enmod rewrite
Usage
List your applications
./agent list applications
Create an application
./agent add application [--provider=] [--token=] [--repository-provider=] [--repository=] [--pipeline=] [--name=] [--path=]
- --provider The application provider to use (currently, continuousphp is the only supported application provider)
- --token A valid token to consume the provider API (ie: continuousphp API token)
- --repository-provider The repository provider to use (ie: git-hub, bitbucket...)
(for continuousphp only) - --repository The repository key to use (ie: continuousphp/deploy-agent)
- --pipeline The pipeline to use (ie: refs/heads/master)
(for continuousphp only) - --name The name of the application
- --path The destination path of the application
Token
The token
depends on the Provider. At this time, the continousphp API is the only one supported.
You can retrieve your personal token
on your Profile page at continuousphp.com/profile
Deploy an application
./agent deploy application [--name=] [--build=]
- --name The name of the application
- --build The ID of the build to deploy
Application path
When a deployment occurs, the Deploy Agent creates a new folder for every build in its dedicated workspace. To enable the new build, it will create/update a symlink to the current build
[application-path]
|
+---[/current] (symlink to current build)
|
+---[/build-1]
|
+---[/build-2]
Hooks
During the deployment workflow the Deploy Agent can execute project specific commands through hooks to define in a continuous.yml file as following:
# continuous.yml deployment: hooks: AfterInstall: - command: echo 'the application is successfully installed' BeforeActivate: - command: echo 'the application is going to start' AfterActivate: - command: echo 'the application has started'
Webhook setup
The URL of the hook to implement in continuousphp is <baseuri>/webhook/continuousphp
.
Configure it as following:
Events
- AfterInstall : triggered just after the application package has been extracted
- BeforeActivate : triggered just before the symlink update
- AfterActivate : triggered just after the symlink update
Contributing
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Feel free to fork the project, create a feature branch, and send us a pull request!