Skip to content

Commit d908d73

Browse files
committed
📚 Sync docs from alaudadevops/tektoncd-operator on aaa0b4b3ec2c815f5559bb1747a6c05e451cf358
Source: docs: adjust release notes and lifecycle policy for v4.1.0 (#209) Author: l-qing Ref: refs/heads/release-4.1 Commit: aaa0b4b3ec2c815f5559bb1747a6c05e451cf358 This commit automatically syncs documentation changes from the source-docs repository. 🔗 View source commit: AlaudaDevops/tektoncd-operator@aaa0b4b 🤖 Synced on 2025-07-10 09:54:36 UTC
1 parent 8cf3b3e commit d908d73

File tree

8 files changed

+1334
-812
lines changed

8 files changed

+1334
-812
lines changed

‎.github/SYNC_INFO.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Documentation Sync Information
22

3-
- **Last synced**: 2025-07-07 03:52:51 UTC
3+
- **Last synced**: 2025-07-10 09:54:35 UTC
44
- **Source repository**: alaudadevops/tektoncd-operator
5-
- **Source commit**: [d9a71adfda077eb458d051aac93f41addfce332e](https://github.com/alaudadevops/tektoncd-operator/commit/d9a71adfda077eb458d051aac93f41addfce332e)
6-
- **Triggered by**: yuzichen12123
7-
- **Workflow run**: [#9](https://github.com/alaudadevops/tektoncd-operator/actions/runs/16107170334)
5+
- **Source commit**: [aaa0b4b3ec2c815f5559bb1747a6c05e451cf358](https://github.com/alaudadevops/tektoncd-operator/commit/aaa0b4b3ec2c815f5559bb1747a6c05e451cf358)
6+
- **Triggered by**: l-qing
7+
- **Workflow run**: [#10](https://github.com/alaudadevops/tektoncd-operator/actions/runs/16191945982)
88

99
## Files synced:
1010
- docs/

‎docs/en/overview/lifecycle_policy.mdx‎

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
weight: 30
2+
weight: 35
33
---
44

55
# Lifecycle Policy
@@ -8,17 +8,24 @@ weight: 30
88

99
Below is the lifecycle schedule for released versions of the `Alauda DevOps Pipelines` operator:
1010

11-
| Alauda DevOps Pipelines Version | Tekton Component Versions | Release Date | End of Support |
12-
| :----: | ------------------------ | :----------: | :--------------: |
13-
| v4.1.z | Pipelines: v0.65.z<br />Chains: v0.23.z<br />Pipelines-as-Code: v0.32.z<br />Results: v0.13.z<br />Triggers: v0.30.z<br />Tekton Hub: v1.19.z | 2025-?-? | 2026-?-? |
11+
| Alauda DevOps Pipelines Version | Release Date | End of Support |
12+
| :----: | :----------: | :--------------: |
13+
| v4.1.x | 2025-07-14 | 2025-11-14 |
14+
| v4.0.x (LTS) | 2025-04-08 | 2026-04-08 |
15+
16+
> For detailed component versions, see the [Compatibility and support matrix](./release_notes.mdx#compatibility-and-support-matrix)
1417
1518
## Release Policy
1619

17-
The `Alauda DevOps Pipelines` operator releases a new version every four to six months, updating the operator to the latest or second latest [LTS](https://github.com/tektoncd/community/blob/main/releases.md#support-policy) version officially released by Tekton.
20+
A new minor version of the `Alauda DevOps Pipelines` operator is released every month.
21+
22+
Within every 4-month period, the last minor version will be selected as a Long Term Support (LTS) version. LTS versions are supported for 12 months, while non-LTS versions are supported four months.
23+
24+
During these four months, we will update to the latest or second [LTS](https://github.com/tektoncd/community/blob/main/releases.md#support-policy) version officially released by Tekton.
1825

1926
## Maintenance Policy
2027

21-
Alauda provides 12 months of maintenance support for each released version of the Tekton operator.
28+
Alauda provides maintenance support for 12 months for LTS versions and 4 months for non-LTS versions of the Tekton operator.
2229

2330
During the maintenance period, Alauda will provide the following services to customers:
2431

‎docs/en/overview/release_notes.mdx‎

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,28 +10,40 @@ title: Release Notes
1010
# Release Notes
1111

1212
::: tip
13-
The maintenance period for version **v4.1.z** is from ? ?, 2025 to ? ?, 2026.
13+
The maintenance period for version **v4.1.x** is from July 14, 2025 to Nov 14, 2026.
1414
:::
1515

1616
## Compatibility and support matrix
1717

1818
The following table shows the compatibility and support matrix between the `Alauda DevOps Pipelines` operator and ACP versions.
1919

20-
| Alauda DevOps Pipelines Version | Tekton Component Versions | ACP Version |
21-
| :------: | ------------------------- | :----------: |
22-
| v4.1.z | Pipelines: v0.65.5<br />Chains: v0.23.0<br />Pipelines-as-Code: v0.32.0<br />Results: v0.13.2<br />Triggers: v0.30.1<br />Tekton Hub: v1.19.2 | v4.0, v4.1 |
20+
| Alauda DevOps Pipelines Version | Component Version | | | | | | ACP Version |
21+
|:------:|:------:|:------:|:------:|:------:|:------:|:------:|:------:|
22+
| **Operator** | **Pipelines** | **Triggers** | **CLI** | **Chains** | **Hub** | **Results** | |
23+
| 4.1.0 | 0.65.7 | 0.30.1 | 0.39.1 | 0.23.1 | 1.19.2 | 0.14.0 | 4.0 |
24+
| 4.0.x (LTS) | 0.65.x | 0.30.x | 0.39.x | 0.23.x | 1.19.x | 0.13.x | 4.0 |
2325

2426
## v4.1.0
2527

2628
### New and Optimized Features
2729

28-
TODO: Add new features and optimizations for v4.1.0
30+
This release enhances task capabilities, strengthens Pipeline security, introduces standardized Java templates, improves execution efficiency via Trigger configurations, and optimizes end-to-end orchestration experience.
31+
32+
- Expanded Task Capabilities
33+
- Support for kubectl Task: Directly operate Kubernetes resources.
34+
- Support for git Task: Simplify code repository interaction processes.
35+
- Enhanced Pipeline Security
36+
- Integration of syft Task: Automatically generate image SBOM.
37+
- Integration of cosign Task: Implement image signing and verification.
38+
- Integration of trivy Task: Conduct vulnerability scanning and dependency security detection.
39+
- Provide standardized Java Pipeline templates, covering the entire workflow of compilation, scanning, building, and deployment.
40+
- Pipelines support Trigger Template configuration to improve pipeline execution efficiency.
41+
- Optimize the end-to-end user experience of orchestrating Pipelines.
2942

3043
### Fixed Issues
3144

32-
{/* release-notes-for-bugs?template=fixed&project=DEVOPS&version=v4.1 (next) */}
45+
{/* release-notes-for-bugs?template=fixed&project=DEVOPS&version=v4.1.0 */}
3346

3447
### Known Issues
3548

36-
{/* release-notes-for-bugs?template=unfixed&project=DEVOPS&version=v4.1 (next) */}
37-
49+
{/* release-notes-for-bugs?template=unfixed&project=DEVOPS&version=v4.1.0 */}

‎docs/en/upgrade.mdx‎

Lines changed: 0 additions & 119 deletions
This file was deleted.

‎docs/en/upgrade/index.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
weight: 245
3+
---
4+
5+
# Upgrade
6+
7+
<Overview />
Lines changed: 141 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,141 @@
1+
---
2+
weight: 10
3+
---
4+
5+
# Upgrade `Alauda DevOps Pipelines` Operator
6+
7+
This document provides instructions for upgrading the `Alauda DevOps Pipelines` Operator to a newer version using the `Marketplace`/`OperatorHub` interface in your cluster. The upgrade process is designed to be straightforward while ensuring minimal disruption to existing Tekton resources.
8+
9+
## Upgrade Overview
10+
11+
Upgrading the `Alauda DevOps Pipelines` Operator allows you to access new features, bug fixes, and improvements to the Tekton ecosystem. The `Alauda DevOps Pipelines` Operator handles the upgrade of all Tekton components (Pipelines, Triggers, Hub, etc.) according to your configuration.
12+
13+
## Before You Begin
14+
15+
Before upgrading the `Alauda DevOps Pipelines` Operator, ensure you:
16+
17+
- Have administrative access to your cluster
18+
- Review the release notes for the new version to understand any breaking changes
19+
- Verify that your existing Tekton component configurations are compatible with the new version
20+
- Confirm that all Tekton components are in a ready state
21+
22+
## Upgrade Process
23+
24+
### Using `Marketplace`/`OperatorHub`
25+
26+
1. **Access the `Marketplace`/`OperatorHub`**
27+
- Log in to your cluster's management console
28+
- Navigate to the `Marketplace` or `OperatorHub` section
29+
30+
2. **Locate the `Alauda DevOps Pipelines` Operator**
31+
- Search for `Alauda DevOps Pipelines` in the search bar
32+
- Click on the `Alauda DevOps Pipelines` card
33+
34+
3. **View Available Versions**
35+
- On the `Alauda DevOps Pipelines` Operator details page, you'll see information about the currently installed version
36+
- The interface will indicate if a newer version is available
37+
- You can click different `Channels` to view all available versions
38+
39+
4. **Initiate the Upgrade**
40+
- If the target version is in a different `Channel`, switch to the corresponding `Channel` in the `Subscription` first
41+
- If the current `Channel` has a newer version available, you will see a prompt:
42+
- **New Version Detected**
43+
- To upgrade only the current Operator, click `Confirm` to upgrade.
44+
45+
5. **Configure Upgrade Settings (if applicable)**
46+
- Some upgrades may present configuration options
47+
- In most cases, the default settings will preserve your existing configuration
48+
49+
6. **Confirm and Start the Upgrade**
50+
- Click `Confirm` to begin the process
51+
- Review the upgrade details and confirm your selection
52+
- The system will update the `Alauda DevOps Pipelines` Operator while maintaining your custom resources
53+
54+
7. **Monitor the Upgrade**
55+
- The upgrade progress will be displayed in the `OperatorHub` interface
56+
- You can also check the status in the `tekton-operator` namespace:
57+
```bash
58+
$ kubectl get pods -n tekton-operator
59+
```
60+
When all pods are in `Running` state, the operator upgrade is complete.
61+
The operator will then automatically upgrade components such as `Pipelines`, `Triggers`, `Hub`, `Chains`, etc.
62+
- Check the components upgrade status:
63+
```bash
64+
$ kubectl get tektoninstallerset -A
65+
$ kubectl get pods -n tekton-pipelines
66+
```
67+
When all components and pods are in `Ready` state, the components upgrade is complete.
68+
69+
8. **Verify the Upgrade**
70+
- Check that the `Alauda DevOps Pipelines` Operator version has been updated:
71+
```bash
72+
$ kubectl get csv -n tekton-operator
73+
74+
NAME DISPLAY VERSION REPLACES PHASE
75+
tektoncd-operator.v4.x.x Alauda DevOps Pipelines 4.x.x x Succeeded
76+
```
77+
When the `VERSION` matches the new version, the upgrade is complete.
78+
- Verify that your Tekton components are functioning correctly
79+
- Test that your pipelines can run successfully
80+
81+
## Post-Upgrade Steps
82+
83+
After the upgrade completes successfully:
84+
85+
1. **Verify Component Status**
86+
- Check that all Tekton components have been updated:
87+
```bash
88+
kubectl get tektonconfig,tektonpipeline,tektontrigger -A
89+
kubectl get tektoninstallerset -A
90+
```
91+
92+
2. **Test Functionality**
93+
- Run a simple pipeline to verify that the system is working correctly
94+
- Ensure that all existing integrations continue to function
95+
96+
3. **Update Custom Resources if Needed**
97+
- If the new version introduces changes to CRDs, you may need to update your custom resources
98+
- Refer to the release notes for specific migration steps
99+
100+
## Rollback Procedure
101+
102+
If you encounter issues with the new version, you can roll back to the previous version:
103+
104+
1. Return to the `Marketplace`/`OperatorHub` interface
105+
2. Select the `Alauda DevOps Pipelines` Operator
106+
3. `Uninstall` the current version
107+
4. Choose the previous version from the version list
108+
5. Follow the installation process for that version
109+
110+
:::note
111+
Downgrading may require additional steps to ensure compatibility of your resources with the older version.
112+
113+
This depends on the differences between the version you upgraded from and the version you upgraded to. If the differences are large, you may need to manually migrate resources.
114+
:::
115+
116+
## Troubleshooting
117+
118+
If you encounter issues during or after the upgrade:
119+
120+
- Check the `Alauda DevOps Pipelines` Operator pod logs:
121+
```bash
122+
$ kubectl logs -l name=tekton-operator -n tekton-operator
123+
```
124+
125+
- Verify the status of your Tekton resources:
126+
```bash
127+
$ kubectl get tektonconfig config -o yaml
128+
```
129+
130+
- Ensure that all components have the expected status:
131+
```bash
132+
$ kubectl get tektoninstallerset
133+
```
134+
135+
## Next Steps
136+
137+
After successfully upgrading the `Alauda DevOps Pipelines` Operator:
138+
139+
- Explore new features introduced in the latest version
140+
- Update your CI/CD pipelines to leverage new capabilities
141+
- Consider enabling additional components that may be available in the new version

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"devDependencies": {
3-
"@alauda/doom": "^1.7.1",
3+
"@alauda/doom": "^1.9.1",
44
"typescript": "^5.8.3"
55
},
66
"scripts": {

0 commit comments

Comments
 (0)