Skip to content

Commit f9364f4

Browse files
btunguthangy
andauthored
Release/v2.3.0 (#40)
* Update VSTS agent version to 4.255.0 in Dockerfile * Bump chart version to 2.3.0 * feat: Add `git-lfs` to base image (#37) by hangy * docs: Update README with release notes for version 2.3.0 and add `git-lfs` support * refactor: Update resource limits section in values.yaml to be commented out (#39) * docs: Update README with breaking change regarding container resource requests and limits * fix: Update appVersion and image tag to v2.3.0-vsts-v2.255.0 --------- Co-authored-by: hangy <hangy@hangy.de>
1 parent e7a4942 commit f9364f4

File tree

5 files changed

+162
-78
lines changed

5 files changed

+162
-78
lines changed

Dockerfile

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ ARG ARG_UBUNTU_BASE_IMAGE_TAG="20.04"
44
FROM ${ARG_UBUNTU_BASE_IMAGE}:${ARG_UBUNTU_BASE_IMAGE_TAG}
55
WORKDIR /azp
66
ARG ARG_TARGETARCH=linux-x64
7-
ARG ARG_VSTS_AGENT_VERSION=4.251.0
7+
ARG ARG_VSTS_AGENT_VERSION=4.255.0
88

99

1010
# To make it easier for build and release pipelines to run apt-get,
@@ -20,6 +20,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
2020
ca-certificates \
2121
curl \
2222
git \
23+
git-lfs \
2324
iputils-ping \
2425
jq \
2526
lsb-release \

README.md

Lines changed: 44 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@ You can watch the tutorial video below to learn how to deploy Azure DevOps agent
1414
1515
[![Azure DevOps Agent on Kubernetes - How to deploy build agents on Kubernetes - Tutorial](https://img.youtube.com/vi/qep2l1oxknk/0.jpg)](https://www.youtube.com/watch?v=qep2l1oxknk)
1616

17-
1817
## Compatibility Matrix
1918

2019
The table presented below outlines the correspondence between Helm chart versions, Docker tags, and the Azure DevOps agent versions included within those Docker images.
2120

2221
| Helm Version | Docker Tag | Agent Version |
2322
| ------------ | --------------------- | ------------- |
23+
| 2.3.0 | v2.3.0-vsts-v2.255.0 | 4.255.0 |
2424
| 2.2.0 | 4.251.0-stable-v2.2.0 | 4.251.0 |
2525
| 2.1.1 | 3.248.0-stable-v2.1.0 | 3.248.0 |
2626
| 2.1.0 | 3.248.0-stable-v2.1.0 | 3.248.0 |
@@ -30,6 +30,23 @@ The table presented below outlines the correspondence between Helm chart version
3030

3131
## Important Release Notes
3232

33+
### 2.3.0
34+
35+
With the **2.3.0 release**, the helm chart has been updated to use the latest Azure DevOps agent version **4.255.0** and `git-lfs` support has been added.
36+
37+
- :white_check_mark: [Upgrade VSTS agent to 4.255.0](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/38)
38+
- :white_check_mark: [Add git-lfs support](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/37)
39+
- :white_check_mark: [BREAKING CHANGE: Change container resources requests and limits to NULL / empty / `{}`](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/39)
40+
41+
42+
#### IMPORTANT & BREAKING CHANGE
43+
44+
- The values of **requests and limits for the container resources** have been changed from specific values to NULL / empty / `{}`.
45+
46+
> This means that the container will use the default values of the Kubernetes cluster for CPU and memory resources. Please make sure to adjust the values according to your needs if you want to set specific values for CPU and memory resources.
47+
48+
**To see the changes**, please visit the [values.yaml changes for PR 39](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/39/files)
49+
3350
### 2.2.0
3451

3552
This helm release uses the latest stable Azure Devops Agent version which is **4.251.0**.
@@ -44,13 +61,11 @@ This helm release deploys the same agent version but contains `sideContainers` s
4461
- :white_check_mark: [Feature add sideContainers support](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/33)
4562
- :white_check_mark: [Add sidecar containers](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/31)
4663

47-
4864
### 2.1.0
4965

5066
This release includes the same agent version but different Docker image tag and **different bash invocations**!
51-
- :white_check_mark: [Add sudo and docker support](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/27)
52-
5367

68+
- :white_check_mark: [Add sudo and docker support](https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/27)
5469

5570
### 2.0.1
5671

@@ -59,16 +74,13 @@ This release includes the same agent version but different Docker image tag and
5974
- :white_check_mark: [Upgrade VSTS agent to 3.248.0](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/23)
6075
- :white_check_mark: Optimize the Dockerfile steps and add comment lines.
6176

62-
63-
6477
### 2.0.0
6578

6679
- :white_check_mark: [ubuntu 20.04 based image](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/13)
6780
- :white_check_mark: [yq upgrade to 4.40.7](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/12)
6881
- :white_check_mark: [docker command could be executed without sudo](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/11)
6982
- :white_check_mark: [Support for VSTS agent 3.232.3](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/10)
7083

71-
7284
### 1.0.9
7385

7486
- Pod Annotations have been implemented
@@ -78,19 +90,19 @@ This release includes the same agent version but different Docker image tag and
7890

7991
:white_check_mark: PR: https://github.com/btungut/azure-devops-agent-on-kubernetes/pull/8
8092

81-
8293
### 1.0.8
83-
Since the **1.0.8 release** , the Dockerfile and Helm chart have been configured to utilize a non-root user.
94+
95+
Since the **1.0.8 release** , the Dockerfile and Helm chart have been configured to utilize a non-root user.
8496

8597
:white_check_mark: [Issue : Non-root user should be implemented](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/3)
8698

8799
:white_check_mark: [Issue : docker could be called without sudo](https://github.com/btungut/azure-devops-agent-on-kubernetes/issues/5)
88100

89101
## Prerequisites
102+
90103
- Helm
91104
- Personal Access Token (**PAT**) with `Agent Pool manage` scope
92105

93-
94106
You don't need to follow any more instructions beyond the **standard self-hosted agent installation** in order to utilize this helm chart.
95107

96108
## Generate PAT on Azure DevOps
@@ -104,8 +116,8 @@ It is pretty straight-forward process with sufficient scope. Please choose **one
104116

105117
## Installing the Chart
106118

107-
108119
1. First you need to add repository _(if you haven't done yet before)_
120+
109121
```bash
110122
helm repo add btungut https://btungut.github.io
111123
```
@@ -120,7 +132,7 @@ helm install {RELEASE-NAME} btungut/azure-devops-agent \
120132
--namespace {YOUR-NS}
121133
```
122134

123-
2. Install the helm chart with existing secret that stores PAT
135+
1. Install the helm chart with existing secret that stores PAT
124136

125137
```bash
126138
helm install {RELEASE-NAME} btungut/azure-devops-agent \
@@ -153,7 +165,6 @@ volumeMounts: []
153165
mountPath: "/var/run/docker.sock"
154166
```
155167
156-
157168
## Example overriden values.yaml for running instance
158169
159170
This the example values.yaml that you can use to run an instance with provided PAT secret and Docker CLI support.
@@ -206,7 +217,6 @@ volumeMounts:
206217
mountPath: "/var/run/docker.sock"
207218
```
208219

209-
210220
## Parameters
211221

212222
### Agent authentication parameters
@@ -219,48 +229,44 @@ volumeMounts:
219229
| `agent.patSecret` | (2nd Option) Already existing secret name that stores PAT | `""` |
220230
| `agent.patSecretKey` | (2nd Option) Key (field) name of the PAT that is stored in secret | `"pat"` |
221231

222-
223232
### Agent configuration parameters
224233

225-
| Name | Description | Value |
226-
| ------------------------ | ----------------------------------------------------------------------------- | ----------- |
227-
| `agent.organizationUrl` | Server / organization url, e.g.: https://dev.azure.com/your-organization-name | `""` |
228-
| `agent.pool` | Agent pool name which the build agent is placed into | `"Default"` |
229-
| `agent.workingDirectory` | Working directory of the agent | `"_work"` |
230-
| `agent.extraEnv` | Additional environment variables as dictionary | `{}` |
234+
| Name | Description | Value |
235+
| ------------------------ | ------------------------------------------------------------------------------- | ----------- |
236+
| `agent.organizationUrl` | Server / organization url, e.g.: `https://dev.azure.com/your-organization-name` | `""` |
237+
| `agent.pool` | Agent pool name which the build agent is placed into | `"Default"` |
238+
| `agent.workingDirectory` | Working directory of the agent | `"_work"` |
239+
| `agent.extraEnv` | Additional environment variables as dictionary | `{}` |
231240

232241
### Other parameters
233242

234-
| Name | Description | Value |
235-
| --------------------------- | ------------------------------------- | ---------------------------- |
236-
| `image.registry` | Azure DevOps agent image registry | `docker.io` |
237-
| `image.repository` | Azure DevOps agent image repository | `btungut/azure-devops-agent` |
238-
| `image.tag` | Azure DevOps agent image tag | refer to values.yaml |
239-
| `image.pullPolicy` | Azure DevOps agent image pull policy | `IfNotPresent` |
240-
| `image.pullSecrets` | Azure DevOps agent image pull secrets | `[]` |
241-
| `replicaCount` | Replica count for deployment | `1` |
242-
| `resources.requests.cpu` | CPU request value for scheduling | `"100m"` |
243-
| `resources.requests.memory` | Memory request value for scheduling | `"128Mi"` |
244-
| `resources.limits.cpu` | CPU limit value for scheduling | `"500m"` |
245-
| `resources.limits.memory` | Memory limit value for scheduling | `"512Mi"` |
246-
| `volumes` | Volumes for the container | `[]` |
247-
| `volumeMounts` | Volume mountings | `[]` |
243+
| Name | Description | Value |
244+
| --------------------------- | ---------------------------------------------- | ---------------------------- |
245+
| `image.registry` | Azure DevOps agent image registry | `docker.io` |
246+
| `image.repository` | Azure DevOps agent image repository | `btungut/azure-devops-agent` |
247+
| `image.tag` | Azure DevOps agent image tag | refer to values.yaml |
248+
| `image.pullPolicy` | Azure DevOps agent image pull policy | `IfNotPresent` |
249+
| `image.pullSecrets` | Azure DevOps agent image pull secrets | `[]` |
250+
| `replicaCount` | Replica count for deployment | `1` |
251+
| `resources` | Resource requests and limits for the container | `{}` |
252+
| `volumes` | Volumes for the container | `[]` |
253+
| `volumeMounts` | Volume mountings | `[]` |
248254

249255
Please refer the values.yaml for other parameters.
250256

251-
252-
253257
## Built-in binaries & packages
258+
254259
The binaries and packages listed below are included in the docker image used by the helm chart:
260+
255261
- Ubuntu 20.04
256262
- unzip
257263
- jq
258264
- yq
259265
- git
266+
- git-lfs
260267
- helm
261268
- kubectl
262269
- Powershell Core
263270
- Docker CLI
264271
- Azure CLI
265272
- with Azure DevOps extension
266-

chart/Chart.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ apiVersion: v2
22
name: azure-devops-agent
33
description: Dockerized Azure DevOps build agent on Kubernetes
44
type: application
5-
version: 2.2.0
6-
appVersion: "4.251.0-stable-v2.2.0"
5+
version: 2.3.0
6+
appVersion: "v2.3.0-vsts-v2.255.0"
77
keywords:
88
- azure devops
99
- build agent

0 commit comments

Comments
 (0)