Github actions
Steps and examples on how to setup a build and deployment pipeline for Umbraco Deploy using GitHub Actions.
In this example we will show how you can set up a CI/CD build server using Github Actions in Azure Web Apps.
We will not cover how you can set up the site itself as this is beyond this documentation.
The following steps will take you through setting up a build server in Azure Web Apps. Go to the Azure portal and find the empty website that we have set up and want to connect to.
Go to the Deployment Center.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Fumbraco%2FUmbracoDocs%2Fblob%2Fmain%2F10%2Fumbraco-deploy%2Finstalling-deploy%2Fimages%2FDeployment-center.png&width=768&dpr=4&quality=100&sign=bc42286b&sv=1)
In the Deployment Center we can set up the CI/CD build server. With this example we are going to set up our build server by using Github Actions. It is possible to set up the build server however you want as long as it supports executing powershell scripts.
Go to the Settings tab.
Choose which source and build provider to use.
In this case we want to choose Github.
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Fumbraco%2FUmbracoDocs%2Fblob%2Fmain%2F10%2Fumbraco-deploy%2Finstalling-deploy%2Fcicd-pipeline%2Fimages%2FBuild-server-v10.png&width=768&dpr=4&quality=100&sign=3ad307db&sv=1)
Choose the Organization which you created our Github repository under.
Choose the repository that was set up earlier in this guide.
Select which branch that we want the build server to build into.
We can see which runtime stack and version we are running, in this example we are running .NET and Version 6.0.
Once the information has been added we can go ahead and preview the YAML file that will be used for the build server:
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Fumbraco%2FUmbracoDocs%2Fblob%2Fmain%2F10%2Fumbraco-deploy%2Finstalling-deploy%2Fcicd-pipeline%2Fimages%2Fworkflow-preview-v10.png&width=768&dpr=4&quality=100&sign=595c3183&sv=1)
Save the workflow.
The website and the Github repository are now connected.
If we go back to the Github repository we can see that a new folder have been created called Workflows:
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Fumbraco%2FUmbracoDocs%2Fblob%2Fmain%2F10%2Fumbraco-deploy%2Finstalling-deploy%2Fimages%2Fworkflows.png&width=768&dpr=4&quality=100&sign=5d21684c&sv=1)
Inside the folder, we find that the YAML file has been created with the default settings from the Azure Portal. The file will need to be configured so it fits into your set up.
Pull down the new file and folder, so you can work with the YAML file on your local machine.
Configure it to work with our Umbraco Deploy installation.
When it have been configured it will look something like this:
This is only an example of how you can set up the CI/CD pipeline for Umbraco Deploy. It is possible to set it up in a way that works for you and your preferred workflow.
We also need to add the License file and TriggerDeploy.ps1
file in an item group in the csproj
file:
As well as enabling Unattended install in the appSettings.json file so Umbraco installs automatically:
Before the build can work, we will need to set up our generated API key to work with the build server in GitHub Actions.
Open your Github repository.
Navigate to Settings.
Go to the Secrets tab.
Select "New repository secret".
Call the new secret "DEPLOYAPIKEY".
Add the API key from the
appSettings.json
file.Save the secret.
We can now go ahead and commit the configured YAML file and push up all the files to the repository.
Go to Github where you will now be able to see that the CI/CD build has started running:
The build server will go through the steps in the YAML file, and once it is done the deployment have gone through successfully:
![](https://docs.umbraco.com/~gitbook/image?url=https%3A%2F%2Fgithub.com%2Fumbraco%2FUmbracoDocs%2Fblob%2Fmain%2F10%2Fumbraco-deploy%2Finstalling-deploy%2Fimages%2Fdeployment-complete%2520%281%29.png&width=768&dpr=4&quality=100&sign=173b50fa&sv=1)
You can now start creating content on the local machine. Once you create something like a Document Type, the changes will get picked up in Git.
When you're done making changes, commit them and deploy them to Github. The build server will run and extract the changes into the website in Azure.
This will only deploy the schema data for our local site to your website.
You will need to transfer content and media from the backoffice on your local project using the queue for transfer feature.
Last updated