Automatic Git deployments via BitBucket to Plesk based hosting

Overview

Plesk features Git integration, which allows to you automatically deploy your code repositories direct to your website. This can be used for a specific directory, for example a WordPress theme or plugin. This article will step you through the process to configure Git integration using a BitBucket based repository.

We also have guides available for GitLab and GitHub.

Instructions

1. Login to Plesk or the Conetix Control Panel.
2. Select the website you wish to use Git based deployment with.
3. Select the Git option:
   
4. In a new window or tab, Login to BitBucket, and select the repository you wish to deploy. In this example, we’re going to configure conetix/conetix-demo-theme:
   
5. Select Clone, enable SSH and then copy the git@ component of the URL provided:
   
   
6. Return to the Plesk config and paste the URL into the dialog:
   
   Do not hit OK yet.
7. On the right hand side within Plesk, click on the httpdocs folder:
   
8. This will open up a dialog. If this is a WordPress theme or similar, select the path (eg /wp-content/themes) and create a new folder or select a previous directory if replacing an existing theme”
   
   All files will be replaced if you select an existing folder.
9. Double check that the desired folder has now been set:
   
10. Take a copy the SSH public key:
    
    Do not click on OK yet.
11. Then, go back to the browser tab with BitBucket open.
12. On the right hand side, select Repository Settings:
    
13. Then, select Access keys under General:
    
14. Click Add key and add a name for the key along with the public SSH key you copied from Plesk:
    
    
15. Click Add SSH key to save.
16. Return to the Plesk browser window, triple check you have the correct directory selected and click on OK. This will trigger the deployment and you should see something similar to the following:
    
17. After the initial deployment, you should then see a summary screen with the Git configuration. Select Repository Settings:
    
18. Take a copy of the webhook URL:
    
19. Return to the browser window with BitBucket then select Workflow -> Webhooks:
    
20. Click Add webhook and add the URL in as well as an optional title. Leave all other settings as default:
    
21. Click Save and confirm it was added.
22. Return to the Plesk browser window and simply cancel the dialog to edit the Repository Settings (we just needed open to copy the webhook).
23. To confirm the files are deployed, you can use the Plesk File Manager to browse to the file location and confirm it pulled down the code changes: