nucleus / laravel-deploy
A Laravel 5 package to deploy your application to a Nucleus managed server.
Installs: 240
Dependents: 0
Suggesters: 0
Security: 0
Stars: 14
Watchers: 4
Forks: 2
Open Issues: 0
Language:HTML
Requires
- php: ^7.1
- laravel/envoy: ^1.5
- spatie/laravel-backup: ^6.1
README
This Laravel package allows you to easily deploy your application to any server you have SSH access to. While it'll work for pretty much any type of server, it's optimized for Nucleus managed servers. We take care of the hosting & uptime, you can focus on the application.
You can use this package to deploy on your own servers, Forge servers, ... you name it.
Installation
In your application, install the package as such:
composer require nucleus/laravel-deploy
Next, publish the package's content.
php artisan vendor:publish --provider=Nucleus\\Deploy\\DeployServiceProvider
After the install, the package installs a new artisan
command to allow you to quickly deploy.
php artisan deploy
It reads your .env
file for more information about where to deploy to.
Configuration
Your .env
will need the following required parameters.
DEPLOY_HOST=
DEPLOY_USER=
DEPLOY_DIR_BASE=
DEPLOY_REPOSITORY=
These configurations will be provided to you by our support team, but they're pretty easy to complete yourself, too.
On top of the above, there are the following optional parameters that allow you to finetune the deployment to your liking.
DEPLOY_SSH_PORT=22
DEPLOY_DIR_RELEASES=releases
DEPLOY_DIR_PERSISTENT=persistent
DEPLOY_CURRENT=current
DEPLOY_BRANCH=master
DEPLOY_SLACK_WEBHOOK=
DEPLOY_SLACK_CHANNEL=
DEPLOY_SLACK_MESSAGE=
DEPLOY_HIPCHAT_WEBHOOK=
DEPLOY_HIPCHAT_ROOM=
DEPLOY_HIPCHAT_FROM=
DEPLOY_HIPCHAT_COLOR=
DEPLOY_HIPCHAT_MESSAGE=
These can be completed to your liking, to finetune the deployment process.
Slack notifications configuration
DEPLOY_SLACK_WEBHOOK
is the entire webhook URL. DEPLOY_SLACK_CHANNEL
is a #channel
or a @user
that will recieve the notification. Both are required to use Slack notifications.
By filling DEPLOY_SLACK_MESSAGE
you can customise the message that will be returned in Slack. If left empty, the message will be the one generated by Envoy.
HipChat notifications
DEPLOY_HIPCHAT_WEBHOOK
is the entire webhook URL. DEPLOY_HIPCHAT_ROOM
is the room
that will recieve the notification, DEPLOY_HIPCHAT_FROM
is a label to be shown in addition to the sender's name. These variable are required to use HipChat notification.
By filling DEPLOY_HIPCHAT_MESSAGE
you can customise the message that will be returned in Slack. If left empty, the message will be the one generated by Envoy.
DEPLOY_HIPCHAT_COLOR
is the background color for message, default is purple.