Add automatic schema management with database dependencies and minor changes

CONTRIBUTING.md

@@ -2,76 +2,126 @@
 
 ## Build and generate template yml locally
 
-```
+```bash
 helm package ./charts/cadence
-helm template cadence-release cadence-0.1.8.tgz > template_out.yaml
+# Replace with current chart version
+helm template cadence-release cadence-0.2.0.tgz > template_out.yaml
 ```
 
 ## Build and deploy to a k8s cluster
 
-1. Build helm package and deploy to a k8s cluster
+### 1. Update dependencies (if needed)
+```bash
+cd charts/cadence
+helm dependency update
+cd ../..
 ```
+
+### 2. Build helm package and deploy to a k8s cluster
+```bash
 helm package ./charts/cadence
-helm upgrade --install cadence-release cadence-0.1.8.tgz \
+# Replace with current chart version
+helm upgrade --install cadence-release cadence-0.2.0.tgz \
     -n cadencetest \
     --create-namespace
 ```
 
-2. Port forward to check the UI
-```
+### 3. Port forward to check the UI
+```bash
 kubectl port-forward svc/cadence-release-web 8088:8088 -n cadencetest
 ```
 
-Visit localhost:8088 and validate it is accessible.
+Visit http://localhost:8088 and validate it is accessible.
 
-3. Port forward frontend service to run CLI commands
-```
+### 4. Port forward frontend service to run CLI commands
+```bash
 kubectl port-forward svc/cadence-release-frontend 7833:7833 -n cadencetest
 ```
 
-4. (optional) Register a domain:
-```
+### 5. (Optional) Register a domain:
+```bash
 cadence \
     --address localhost:7833 \
     --transport grpc \
-    --domain samples-domain \
+    --domain default \
     domain register \
     --retention 1
 ```
 
-5. Run samples:
-- Clone https://github.com/uber-common/cadence-samples
+### 6. Run samples:
+- Clone https://github.com/cadence-workflow/cadence-samples
 
-- Run sample worker (run at samples repo root)
-```
+- Run sample worker (execute at samples repo root):
+```bash
 ./bin/helloworld -m worker
 ```
 
-- Trigger a workflow  (run at samples repo root)
-```
+- Trigger a workflow (execute at samples repo root):
+```bash
 ./bin/helloworld -m trigger
 ```
 
-6. Visit localhost:8088 and validate the new workflow exists!
+### 7. Validate deployment
+Visit http://localhost:8088 and validate the new workflow exists!
 
-## Generate helmdocs
+## Generate helm documentation
 
 Install [helm-docs](https://github.com/norwoodj/helm-docs):
-```
+```bash
 go install github.com/norwoodj/helm-docs/cmd/helm-docs@latest
 ```
 
-Run it
-```
+Generate documentation:
+```bash
 helm-docs
 ```
 
-cadencechart/README.md file should be updated.
+The `charts/cadence/README.md` file should be updated automatically.
+
+## Release Process
+
+### Before making a release:
+
+1. **Update appVersion and dependencies**: 
+   - Check if Cadence has a new release and update `appVersion` in `Chart.yaml`
+   - Verify dependencies are using latest-1 stable versions:
+     - Cassandra: Currently using `11.x.x` from Bitnami 
+     - PostgreSQL: Currently using `16.x.x` from Bitnami  
+     - MySQL: Currently using `12.x.x` from Bitnami
+   - Update `global.image.tag` in `values.yaml` to match `appVersion`
+
+2. **Update dependencies**:
+   ```bash
+   cd charts/cadence
+   helm dependency update
+   cd ../..
+   ```
+
+3. **Test the changes**:
+   - Build and deploy locally following the steps above
+   - Validate all functionality works as expected
+
+4. **Increment chart version**: Update the `version` field in `charts/cadence/Chart.yaml`:
+   - Patch version (0.2.1): Bug fixes, dependency updates
+   - Minor version (0.3.0): New features, breaking changes
+   - Major version (1.0.0): Major breaking changes
+
+5. **Update documentation**: Run `helm-docs` to regenerate the README.md
+
+### Publishing:
+
+After making changes to templates and incrementing the chart version in `charts/cadence/Chart.yaml`, merge your changes to the main branch. 
+
+The automation will handle publishing the new version using [Chart Releaser Action](https://helm.sh/docs/howto/chart_releaser_action/). The Cadence chart is hosted on GitHub Pages.
 
+After the new version is available in the helm repository, deploy it to a Kubernetes cluster to validate the release.
 
-## Publish chart
+## Version Management Checklist
 
-After making changes to templates, increment the chart version in charts/cadence/Chart.yaml.
-Then merge your changes and automation will take care of publishing the new version.
-Cadence chart is hosted on github pages and automation is done using [Chart Releaser Action](https://helm.sh/docs/howto/chart_releaser_action/).
-After new version is available in helm repo, deploy it to a K8s cluster to validate.
+When updating versions, ensure consistency across:
+- [ ] `Chart.yaml`: `version` (chart version) and `appVersion` (Cadence version)
+- [ ] `values.yaml`: `global.image.tag` (should match appVersion)
+- [ ] Dependencies in `Chart.yaml` (check for updates, aim for latest-1 stable)
+- [ ] Update dependencies with `helm dependency update`
+- [ ] Test deployment locally
+- [ ] Run `helm-docs` to update documentation

charts/cadence/templates/.helmignore → charts/cadence/.helmignore

@@ -14,10 +14,11 @@
 *.swp
 *.bak
 *.tmp
-*.orig
 *~
 # Various IDEs
 .project
 .idea/
 *.tmproj
 .vscode/
+# Cadence
+docs/

charts/cadence/Chart.lock

@@ -0,0 +1,12 @@
+dependencies:
+- name: cassandra
+  repository: oci://registry-1.docker.io/bitnamicharts
+  version: 11.4.2
+- name: postgresql
+  repository: oci://registry-1.docker.io/bitnamicharts
+  version: 16.7.13
+- name: mysql
+  repository: oci://registry-1.docker.io/bitnamicharts
+  version: 12.3.5
+digest: sha256:d355eb032d520a4005678225960f11fbce541e4aaea7fce4a7e90ecebcbe1807
+generated: "2025-06-25T16:33:38.605196+02:00"

charts/cadence/Chart.yaml

@@ -1,6 +1,6 @@
 apiVersion: v2
 name: cadence
-version: 0.1.9
+version: 0.2.0
 appVersion: "1.3.1"
 
 description: |
@@ -26,3 +26,17 @@ sources:
 maintainers:
   - name: Cadence Community
     url: https://github.com/cadence-workflow/cadence-charts
+
+dependencies:
+  - name: cassandra
+    version: 11.x.x
+    repository: oci://registry-1.docker.io/bitnamicharts
+    condition: cassandra.enabled
+  - name: postgresql
+    version: 16.x.x
+    repository: oci://registry-1.docker.io/bitnamicharts
+    condition: postgresql.enabled
+  - name: mysql
+    version: 12.x.x
+    repository: oci://registry-1.docker.io/bitnamicharts
+    condition: mysql.enabled