Webloyer

Webloyer is a Web UI for managing Deployer deployments.

Features

Webloyer has the following features:

• Project management
  • Managing deployment settings on a project-by-project basis
• Deployment management on a project-by-project basis
  • 1-click deploying and rolling back
  • Keeping a log of every deployments
  • E-mail notifications can be sent when a deployment finishes
• Recipe management
  • Creating, editing, deleting and listing recipe files
• Server management
  • Creating, editing, deleting and listing server list files
• User management
  • Authentication with e-mail address and password
  • Role-based access control to features
• Web APIs
• Webhooks
  • GitHub
  • Bitbucket

Screenshots

See screenshots.

Requirements

Webloyer has the following requirements:

• PHP >= 7.4.0
• OpenSSL PHP Extension
• PDO PHP Extension
• Mbstring PHP Extension
• Tokenizer PHP Extension

Installation

Local install with warden

clone project and rename .env.local file into .env file, then execute the following command:

warden env up -d --build

Option 1: Download Source Code

1. Download the application source code by using the Composer create-project command:

   composer create-project ngmy/webloyer
   

2. Give write permission to the storage directory and the bootstrap/cache directory for your web server user (e.g. www-data) by running the following command:

   chown -R www-data:www-data storage
   chown -R www-data:www-data bootstrap/cache
   

3. Run the installer by using the Artisan webloyer:install command:

   php artisan webloyer:install
   

   Note: You must be running this command as your web server user.
4. Start the queue listener as a background process by using the Artisan queue:listen command:

   nohup php artisan queue:listen --timeout=0 &
   

   Note: You must be running this command as your web server user.
5. Add the following Cron entry to your server:

   * * * * * php /path/to/webloyer/artisan schedule:run >> /dev/null 2>&1
   

   Note: You must be running this Cron entry as your web server user.
6. Generate webloyer ssh key (used for server authentication fallback) at ~/.ssh/id_rsa and add to each server's authorized_keys

Basic Usage

Step 1: Login to Webloyer

1. Go to the Login page by click the "Login" link.
2. Enter the e-mail address and password.
3. Click the "Login" button to login to Webloyer.

Step 2: Create Your Project

1. Go to the Create Project page by click the "Create" button in the Projects page.
2. Enter your project information. Note: For now, Webloyer only supports the deploy task and the rollback task. Therefore, you must define these tasks in your Deployer recipe file. Note: If you want to use the e-mail notification, you need to enter your e-mail settings from the E-Mail Settings page.
3. Click the "Store" button to finish project creation process.

Step 3: Managing Deployments

1. Go to the Deployments page by click the "Deployments" button.
2. Run the deploy task by click the "Deploy" button. Or run the rollback task by click the "Rollback" button.
3. After the task of execution has been completed, it is possible to go to the Deployment Detail page by click the "Show" button, you can see the details of the task execution results.

Advanced Usage

• Web APIs
• Webhooks

Foundation Library

Webloyer uses Laravel as a foundation PHP framework.

License

Webloyer is open-sourced software licensed under the MIT license.