Deployment Connections
Configure and automate Deployments in the Control Panel
Summary
Each Environment added to the Control Panel can be configured with a fully automated Deployment Pipeline. Connect your code repository to run and monitor deployments in real time.
Connect your repositories to your Company
The Control Panel supports connection to the following GIT providers:
- Github
- GitLab
- Bitbucket
- GitLab Self-Hosted
You must have the Manage Company Deployment Sources permission to configure this connection
Navigate to My Companies in the Control Panel
Select your own company record - if you have access to multiple companies, always configure this in your company
Under Deployment Connections, Select Action > Add Connection
Select which repository service to connect
Follow the instructions to log in and connect your account
Your GIT provider user account must have admin access to the relevant repositories since the Control Panel installs a webhook to be notified of new commits and merges.
If the repo you are accessing is part of an organisation, you will need to request access to that specific organisation on the authorisation screen.
Connect each Environment to a repository and branch
The pipeline will monitor the connected repository or branch and pull in any new commits and merges.
For each Environment (found under Websites > view Website record > Environments) navigate to the Deployments tab
If your Agency has already connected a repository to your Environment, you will be able to view this here but will not be able to update any existing connections. You will still be able to delete and recreate additional connections.
Set the Deployment Source to GIT
Under Repositories select the relevant:
- Pipeline
- Provider
- This is formatted: [Provider] ([Company name]) ([username])
- Repository
- Branch
- Root path
Select a Git Deployment Type
- Manual
- Recommended for Production environments
- This will pull in all commits but will not deploy them to the environment automatically
- Trigger a manual deployment under Deployments by selecting Deploy next to new commits
- Automatic
- This will pull in all commits and automatically deploy them to the environment
Custom Build Commands
Every Environment is pre-configured with a Deployment Pipeline.
To update the Custom Build Commands, edit the Environment Deployment Pipeline
Go to the Pipelines tab
Select edit by the existing Deployment Pipeline
FAQ
Why does the GIT provider user used for the connection require admin access?
Connecting the Control Panel with your GIT provider configures and installs a webhook in GIT. This requires admin level permissions to achieve.
Why can’t I see an organisation repo after connecting my account to the Control Panel?
If the repo is part of an organisation, check that the access to the organisation has been requested. In Github, go to Integrations > Applications > Authorized OAuth Apps. Select the Corefinity Control Panel application and review the Organisation access section.