accompli/accompli

An easy to use and extendable deployment tool for PHP projects.

0.4.0 2017-02-24 14:52 UTC

Requires

• php: ^5.5 || ^7.0
• accompli/chrono: ^0.3.0
• composer/semver: ^1.2
• gisostallenberg/file-permission-calculator: ^1.0
• justinrainbow/json-schema: ^1.3 || ^2.0
• niels-nijens/protocol-stream: ^1.0
• niels-nijens/utilities: ^3.2
• phpseclib/phpseclib: ^2.0
• psr/log: ^1.0
• seld/jsonlint: ^1.3
• symfony/config: ^2.7 || ^3.0
• symfony/console: ^2.7 || ^3.0
• symfony/dependency-injection: ^2.7 || ^3.0
• symfony/event-dispatcher: ^2.7 || ^3.0
• symfony/filesystem: ^2.7 || ^3.0
• symfony/process: ^2.7 || ^3.0
• symfony/yaml: ^2.7 || ^3.0

Requires (Dev)

• phpunit/phpunit: ^4.4
• satooshi/php-coveralls: ^1.0

MIT

• Niels Nijens

• ssh
• sftp
• ftp
• deployment
• ftps
• Accompli

README

An easy to use and extendable deployment tool for PHP projects.

C'est fini. Accompli!

View the complete documentation of Accompli on accompli.readme.io.

Installation using Composer

Run the following command to add the package to the composer.json of your project:

$ composer require accompli/accompli --dev

Versioning

Accompli uses Semantic Versioning 2 for new versions.

Usage

1. Create an accompli.json defining the hosts to deploy to and the tasks to run during install and deployment.

By running the following command, Accompli will guide you in creating a basic accompli.json configuration:

$ vendor/bin/accompli init

Note that below example might not work for your project.

{
  "$extend": "accompli://recipe/defaults.json",
  "hosts": [
    {
      "stage": "test",
      "connectionType": "ssh",
      "hostname": "example.com",
      "path": "/var/www/example.com"
    }
  ],
  "events": {
    "subscribers": [
      {
        "class": "Accompli\\Task\\CreateWorkspaceTask"
      },
      {
        "class": "Accompli\\Task\\RepositoryCheckoutTask",
        "repositoryUrl": "https://github.com/example.com/example.com.git"
      },
      {
        "class": "Accompli\\Task\\DeployReleaseTask"
      },
      {
        "class": "Accompli\\Task\\MaintenanceModeTask"
      }
    ]
  }
}

1. Run Accompli to install a release of your project: vendor/bin/accompli install-release <version>

2. Run Accompli to deploy an installed release of your project: vendor/bin/accompli deploy-release <version> <stage>

For a more detailed description on how to use Accompli, please see the getting started page.

Credits and acknowledgements

• Niels Nijens
• Reyo Stallenberg (creator of the name 'Accompli')

Also see the list of contributors who participated in this project.

License

Accompli is licensed under the MIT License. Please see the LICENSE file for details.