Advanced Usage

September 21, 2022 ยท View on GitHub

The QuickStart provides a nice easy way of using the Azure CLI to create your AKS Environment. However once you've done this, and are more familiar with the tool, then you'll want to initiate AKS Construction is a slightly more mature way.

Level One - Download Bicep + Your own Bicep file

  1. Use the Helper to guide your AKS configuration.
  2. Capture the parameters on the Parameters File tab to a file - this is your configuration
  3. Grab the latest release of the bicep code
  4. Author an Application Main bicep to represent your application (see here for an example)
  5. In your CI/CD system, either using one of the GitHub Action Workflow files as a base, or by coding it yourself - initiate a deployment of the bicep code, using your parameter file
  6. In your CI/CD system, deploy your application(s) to the AKS cluster
  1. Use the Helper to guide your AKS configuration.
  2. Capture the parameters on the Parameters File tab to a file - this is your configuration
  3. Create a Git symbolic link to the AKSC repository with this command git submodule add https://github.com/Azure/AKS-Construction.git aks-construction
  4. Author an Application Main bicep to represent your application, targetting the new aks-construction directory in your repo (see here for an example)
  5. In your CI/CD system, either using one of the GitHub Action Workflow files as a base, or by coding it yourself - initiate a deployment of the bicep code, using your parameter file
  6. In your CI/CD system, deploy your application(s) to the AKS cluster

Samples

These repo's all connect to AKS-Construction using a GIT submodule.

Sample RepoDescription
aksc petclinicThe Java Spring sample app, using AKS Construction bicep driven helm chart installation
selenium grid aks kedaAn implementation of Selenium Grid on AKS
aks workload identityShowcasing the different application identity options for accessing Azure Key Vault from AKS.

Level Three - GitHub Action Workflow

  1. Use the Helper to guide your AKS configuration.
  2. On the Deploy tab, navigate to the GitHub Actions tab
  3. Paste your Workload/Infra GitHub Repo URL into the textbox
  4. Inspect and run the script in the first script box to create an Identity in Azure and the secrets in your GitHub repo
  5. In your repo, create a new file in your .github/workflows folder, pasting in the yaml from the GitHub Actions script box
  6. Commit the file to your main branch
  7. In your repo, navigate to the actions tab and initiate the new workflow
  8. Inspect the created resources in your Azure Subscription