Skip to content

An example GitHub Action using Azure Kubernetes Service (AKS)

License

Notifications You must be signed in to change notification settings

sky9723/example-aks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Azure Kubernetes Service (AKS) GitHub Action Example

An example workflow, using the GitHub Action for Azure to build, tag, and deploy a container image to a running Kubernetes cluster on AKS.

Workflow

The example workflow will trigger on every push to this repo.

For pushes to a feature branch, the workflow will:

  1. Build the Docker image from the included Dockerfile
  2. Tag and push the image to Azure Container Registry (ACR)

For pushes to the default branch (master), in addition to the above Actions, the workflow will:

  1. Update the deployment resource on the running AKS Kubernetes with the latest container image

Prerequisites

The following setup steps must be complete before running the example workflow.

  1. Create an Azure resource group, a logical container into which Azure resources are deployed and managed, in a location of your choice:
    • az group create --name $RESOURCE_GROUP --location $LOCATION (more info)
  2. Create an Azure Container Registry (ACR) instance in your resource group:
    • az acr create --name $REGISTRY --resource-group $RESOURCE_GROUP --sku Basic (more info)
  3. Configure ACR authentication, grant the AKS service principal the correct rights to pull images from ACR:
    • az role assignment create --assignee $AZURE_SERVICE_APP_ID --scope $ACR_ID --role Reader (more info)
  4. Build, tag, and push the included Docker image to ACR
  5. Create an AKS Kubernetes cluster:
    • az aks create --resource-group $RESOURCE_GROUP --name $CLUSTER --node-count 1 --service-principal $AZURE_SERVICE_APP_ID --client-secret $AZURE_SERVICE_PASSWORD --generate-ssh-keys (more info)
  6. Connect to your cluster using kubectl:
    • az aks get-credentials --resource-group $RESOURCE_GROUP --name $CLUSTER (more info)
  7. Apply the included Kubernetes configuration to your cluster:
    • kubectl apply -f ./kconfig.yml

License

This repository is licensed under CC0-1.0, which waives all copyright restrictions.

About

An example GitHub Action using Azure Kubernetes Service (AKS)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published