{"id":21313945,"url":"https://github.com/octopusdeploy/kubernetes-agent-tools-base","last_synced_at":"2026-03-19T19:49:56.441Z","repository":{"id":250668266,"uuid":"833464124","full_name":"OctopusDeploy/kubernetes-agent-tools-base","owner":"OctopusDeploy","description":"| Public | The container images used for Kubernetes agent deployments","archived":false,"fork":false,"pushed_at":"2025-02-17T03:18:23.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-17T04:23:57.725Z","etag":null,"topics":["production","public"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OctopusDeploy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-25T05:38:37.000Z","updated_at":"2025-02-17T03:18:27.000Z","dependencies_parsed_at":"2024-07-29T09:07:51.183Z","dependency_job_id":"6a5aba63-ebc6-4efe-806f-73231cc37fcb","html_url":"https://github.com/OctopusDeploy/kubernetes-agent-tools-base","commit_stats":null,"previous_names":["octopusdeploy/kubernetes-agent-tools-base"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fkubernetes-agent-tools-base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fkubernetes-agent-tools-base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fkubernetes-agent-tools-base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2Fkubernetes-agent-tools-base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OctopusDeploy","download_url":"https://codeload.github.com/OctopusDeploy/kubernetes-agent-tools-base/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243790999,"owners_count":20348385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["production","public"],"created_at":"2024-11-21T18:09:25.298Z","updated_at":"2026-02-14T01:39:44.324Z","avatar_url":"https://github.com/OctopusDeploy.png","language":"Dockerfile","readme":"# Kubernetes Agent Tools Base\n\nThis repo produces a container image that is used by the Kubernetes Agent to execute Kubernetes scripts. It contains the minimum required tooling to run Kubernetes workloads for Octopus Deploy.\n\nSummary: The image packages `kubectl`, `helm`, `powershell` and `curl` on the base image `mcr.microsoft.com/dotnet/runtime-deps`.\n\n## Updating versions\n\nIn the root of the directory there is a file, `versions.json` which contains information about what versions of Kubectl (and thus Kubernetes), Helm \u0026 Powershell are used to generate the images.\nUnder the `tools` object, there are 3 fields with versions arrays (`kubectl`,`helm`,`powershell`), which are used in a matrix to generate the images.\n\nThere is also a `latest` field that represents the kubernetes version that will be tagged with the `latest` tag.\n\n### Tags\n\nThere are 4 tags being published\n\n- `latest` - Assigned to the highest version of the Kubernetes supported by the Kubernetes agent.\n- `{Kubectl Major Version}.{Kubectl Minor Version}` - For each `kubectl` version, there will be an image with the Kubernetes major \u0026 minor version. Example: `1.31`.\n- `{Kubectl Major Version}.{Kubectl Minor Version}-{Random6Chars}` - For each `kubectl` version, there will be an image with the Kubernetes major \u0026 minor version and random 6 char revision hash. Example: `1.31-X5msD0`.\n- `kube{Kubectl Version}-helm{Helm Version}-pwsh{Powershell Version}-{Random6Chars}` - Contains all versions of the tools plus the revision hash. Example `kube1.31.1-helm3.16.1-pwsh7.4.5-X5msD0`. \n\n### What is the `revisionHash`?\n\nThe revision hash is a \"cache-busting\" mechanism to allow the Kubernetes agent to get an updated version of the tools container image without needing to set the `imagePullPolicy` to `Always`. Because Kubernetes will cache the image on the node(s), it's possible that the image does not get re-acquired when there is a tooling update.\n\n#### Generating a new `revisionHash`\n\nAs the `revisionHash` is used in the docker tag, which are case-sensitive, the following command generates a unique 6 char hash.\n\n```bash\nLC_ALL=C tr -dc A-Za-z0-9 \u003c/dev/urandom | head -c 6; echo\n```\n\n### Branch builds \n\nBranch builds will only be pushed the Octopus' Artifactory instance with a prerelease version `{artifactory-hostname}/octopusdeploy/kubernetes-agent-tools-base:{Kubectll Minor Version}.{Kubectl Minor Version}-{Random6Chars}-{Sanitized Branch Name}-{Date}`\nExample: `{artifactory-hostname}/octopusdeploy/kubernetes-agent-tools-base:1.29-X5msD0-tl-push-to-dockerhub-20240424041854`\n\nThe tags can be found from the logs in the Github action workflow under the step \"Create Tag Version`\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctopusdeploy%2Fkubernetes-agent-tools-base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foctopusdeploy%2Fkubernetes-agent-tools-base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctopusdeploy%2Fkubernetes-agent-tools-base/lists"}