DeployTarget Configurations#
DeployTarget configurations are a way to define how a project can deploy to multiple clusters. This feature is useful when you have two clusters, one which could be dedicated for running production workloads, and another that is used for running development workloads.
The configuration for these is not limited to just a production/development split though, so projects could perceivably target more than one specific cluster.
The basic idea of a DeployTarget configuration is that it is a way to easily define how a project can deploy across multiple clusters. It uses the existing methods of checking if a environment is valid
Important Information#
Before going in to how to configure a project to leverage DeployTarget configurations, there are some things you need to know.
-
Environments now have two new fields available to them to identify which DeployTarget(Kubernetes or OpenShift) they have been created on.
-
kubernetesNamespacePattern
-
kubernetes
-
Once an environment has been deployed to a specific DeployTarget, it will always deploy to this target, even if the DeployTarget configuration, or project configuration is modified.
-
This offers some safety to existing environments by preventing changes to DeployTarget configurations from creating new environments on different clusters.
-
This is a new feature that is part of Lagoon, not specifically for DeployTarget configurations.
-
By default, if no DeployTarget configurations are associated to a project, that project will continue to use the existing methods to determine which environments to deploy. These are the following fields used for this.
-
branches
pullrequests
kubernetesNamespacePattern
-
kubernetes
-
As soon as any DeployTarget configurations are added to a project, then all future deployments for this project will use these configurations. What is defined in the project is ignored, and overwritten to inform users that DeployTarget configurations are in use.
-
DeployTarget configurations are weighted, which means that a DeployTarget configuration with a larger weight is prioritized over one with lower weight.
- The order in which they are returned by the query is the order they are used to determine where an environment should be deployed.
-
Active/Standby environments can only be deployed to the same cluster, so your DeployTarget configuration must be able to deploy both those environments to the same target.
-
Projects that leverage the
promote
feature of Lagoon must be aware that DeployTarget configurations are ignored for thedestination
environment. -
The destination environment will always be deployed to the same target that the
source
environment is on, your DeployTarget configuration MUST be configured correctly for thissource
environment. - For safety, it is best to define both the
source
anddestination
environment in the same DeployTarget configuration branch regex.
Configuration#
To configure a project to use DeployTarget configurations, the first step is to add a configuration to a project.
The following GraphQL mutation can be used, this particular example will add a DeployTarget configuration to the project with the project ID 1.
It will allow only the branches that match the name main
to be deployed, and pullrequests
is set to false
.
This means no other branches will be able to deploy to this particular target, and no pull requests will be deployed to this particular target.
The deployTarget
is ID 1, this could be a Kubernetes cluster in a specific region, or designated for a specific type of workload (production or development).
mutation addDeployTargetConfig{
addDeployTargetConfig(input:{
project: 1
branches: "main"
pullrequests: "false"
deployTarget: 1
weight: 1
}){
id
weight
branches
pullrequests
deployTargetProjectPattern
deployTarget{
name
id
}
project{
name
}
}
}
Info
deployTarget
is an alias the Kubernetes or OpenShift ID in the Lagoon API
It is also possible to configure multiple DeployTarget configurations.
The following GraphQL mutation can be used, this particular example will add a DeployTarget configuration to the same project as above.
It will allow only the branches that regex match with ^feature/|^(dev|test|develop)$
to be deployed, and pullrequests
is set to true
so all pull requests will reach this target.
The targeted cluster in this example is ID 2, which is a completely different Kubernetes cluster to what was defined above for the main
branch.
mutation addDeployTargetConfig{
addDeployTargetConfig(input:{
project: 1
branches: "^feature/|^(dev|test|develop)$"
pullrequests: "true"
deployTarget: 2
weight: 1
}){
id
weight
branches
pullrequests
deployTargetProjectPattern
deployTarget{
name
id
}
project{
name
}
}
}
Once these have been added to a project, you can return all the DeployTarget configurations for a project using the following query
query deployTargetConfigsByProjectId{
deployTargetConfigsByProjectId(project:1){
id
weight
branches
pullrequests
deployTargetProjectPattern
deployTarget{
name
id
}
project{
name
}
}
}
# result:
{
"data": {
"deployTargetConfigsByProjectId": [
{
"id": 1,
"weight": 1,
"branches": "main",
"pullrequests": "false",
"deployTargetProjectPattern": null,
"deployTarget": {
"name": "production-cluster",
"id": 1
},
"project": {
"name": "my-project"
}
},
{
"id": 2,
"weight": 1,
"branches": "^feature/|^(dev|test|develop)$",
"pullrequests": "true",
"deployTargetProjectPattern": null,
"deployTarget": {
"name": "development-cluster",
"id": 2
},
"project": {
"name": "my-project"
}
}
]
}
}