Atomic Deployment is a very useful and very powerful feature that automates Git deployment of your web application.
1. On the Navigation menu, select Atomic Deployment, and then click on Deploy a Project.
2. Fill out a Project Name, whether to Auto deploy on Git Push, and select a Web application, and click on Save Project.
3. Once your project is saved, a Webhook URL will be available on the Web Application Dashboard panel. Copy the URL.
4. Go to your Git repository. In this case, we are using GitHub but BitBucket, SourceForge, or another Git source will work.
Under Settings > Webhooks, click on Add Webhook and paste under Payload URL.
5. Choose application/json under Content Type and click Add Webhook.
6. SSH into the server and navigate to the web application directory by executing this command, changing the appropriate targets.
cd /home/<user>/webapps/<WebApplicationName>
Updates will automatically be reflected seamlessly with any ongoing changes.
7. Finally, you will need to create a Symlink, which ensures that only files that are modified are synced back from server to the Git repository.
Within the Atomic Deployment menu, select Symlink from the navigation menu and click Add New Symlink.
You can select a Config (.env file) if you have Laravel or a similar framework installed that uses the env file.
Scroll down and add the contents of the .env file from your server into the Config Content box.
Or you can select Directory to ensure your Symlink covers an entire Directory for syncing.
Once added, you can see the results on the next page.
Upon returning to the dashboard, you can see the status of the deployment.
You can have multiple symlinks.
This concludes the steps for setting up Atomic Deployment.
The idea of Atomic Deployment is to save you time so you do not have to constantly type a command line or run a script to ensure that the files are safely uploaded from your server to your Git source.
RunCloud will do this automatically for you.
Should you run into any trouble along the way, do not hesitate to reach out to RunCloud Support for additional support.