https://github.com/Alfresco/acs-deployment

Alfresco Content Services containerized deployment (Helm and Docker Compose)
https://github.com/Alfresco/acs-deployment

alfresco alfresco-bdu docker hacktoberfest helm kubernetes ops-readiness-team

Last synced: about 6 hours ago
JSON representation

Alfresco Content Services containerized deployment (Helm and Docker Compose)

• Host: GitHub
• URL: https://github.com/Alfresco/acs-deployment
• Owner: Alfresco
• License: apache-2.0
• Created: 2018-04-05T09:06:13.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-10-29T11:53:37.000Z (19 days ago)
• Last Synced: 2024-10-29T13:28:29.701Z (19 days ago)
• Topics: alfresco, alfresco-bdu, docker, hacktoberfest, helm, kubernetes, ops-readiness-team
• Language: Smarty
• Homepage: https://alfresco.github.io/acs-deployment/
• Size: 9.2 MB
• Stars: 176
• Watchers: 80
• Forks: 243
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-technostructure - Alfresco/acs-deployment - deployment: Alfresco Content Services containerized deployment (Helm and Docker Compose) ([💾 sysadmin-devops](https://github.com/stars/ketsapiwiq/lists/sysadmin-devops))
• awesome-technostructure - Alfresco/acs-deployment - deployment: Alfresco Content Services containerized deployment (Helm and Docker Compose) ([💾 sysadmin-devops](https://github.com/stars/ketsapiwiq/lists/sysadmin-devops))

README

        
# Alfresco Content Services Containerized Deployment

[![release](https://img.shields.io/github/v/release/Alfresco/acs-deployment?display_name=release)](https://github.com/Alfresco/acs-deployment/releases/latest)

![kubernetes tested version](https://img.shields.io/badge/k8s%20version-v1.29-blue)

[![Helm release](https://github.com/Alfresco/acs-deployment/actions/workflows/helm-release.yml/badge.svg)](https://github.com/Alfresco/acs-deployment/actions/workflows/helm-release.yml)

[![helm charts (enterprise)](https://github.com/Alfresco/acs-deployment/actions/workflows/helm-enterprise.yml/badge.svg)](https://github.com/Alfresco/acs-deployment/actions/workflows/helm-enterprise.yml)

[![helm charts (community)](https://github.com/Alfresco/acs-deployment/actions/workflows/helm-community.yml/badge.svg)](https://github.com/Alfresco/acs-deployment/actions/workflows/helm-community.yml)

[![Docker Compose (enterprise)](https://github.com/Alfresco/acs-deployment/actions/workflows/docker-compose-enterprise.yml/badge.svg)](https://github.com/Alfresco/acs-deployment/actions/workflows/docker-compose-enterprise.yml)

[![Docker Compose (community)](https://github.com/Alfresco/acs-deployment/actions/workflows/docker-compose-community.yml/badge.svg)](https://github.com/Alfresco/acs-deployment/actions/workflows/docker-compose-community.yml)

This project contains the code for running Alfresco Content Services (ACS) with

[Docker](https://docs.docker.com/get-started) using [Docker

Compose](https://docs.docker.com/compose) or on

[Kubernetes](https://kubernetes.io) using [Helm Charts](https://helm.sh).

:warning: The [Docker Compose](./docker-compose/compose.yaml) deployment

has moved from a custom NGINX based proxy to Traefik based proxy.

Please read the [documentation](./docs/docker-compose#alfresco-proxy-proxy) for

more details.

User docs available at: [https://alfresco.github.io/acs-deployment/](https://alfresco.github.io/acs-deployment/)

## License

The code in this repository is released under the Apache License, see the [LICENSE](./LICENSE) file for details.

## Contribution Guide

Please use [this guide](CONTRIBUTING.md) to make a contribution to the project and information to report any issues.

## Release

### Helm charts release

New releases are usually made from the default branch. When a bugfix release is

necessary and master branch already received updates that are meant to be

released at a later time, then the release must be made from a branch which

follows the release branch pattern: `release/v$Major.Minor`.

First ensure that:

* the

  [supported-matrix](https://github.com/Alfresco/alfresco-updatecli/blob/master/deployments/values/supported-matrix.yaml)

  reflects the status of the currently released Alfresco products and update if

  necessary before proceeding.

* the [components charts](https://github.com/Alfresco/alfresco-helm-charts) have

  been released in stable versions (no pre-release version should be present in

  Chart.yaml).

Start the release by opening a PR against the appropriate branch that will:

* Update the [EOL table](docs/index.md#acs-end-of-lifed-versions) in case a version is deprecated

* In [alfresco-content-services](helm/alfresco-content-services/Chart.yaml),

  bump chart version to the version you want to release

* Run `pre-commit run --all-files helm-docs` to update helm docs

* Edit [upgrades docs](docs/helm/upgrades.md) renaming the `To be released`

  section to the current version and create a new `To be released` section for

  the future.

* Run [Bump versions][1] workflow against the same newly created branch, the

  first time with `charts` option. Inspect the changes pushed on the branch,

  revert unwanted changes if necessary.

* Run [Bump versions][1] workflow against the same branch with option `values`.

  This will update both docker compose tags and helm charts values.

  Inspect the changes pushed on the branch, looking for any missing update.

[1]: https://github.com/Alfresco/acs-deployment/actions/workflows/bumpVersions.yml

Once the PR has been merged, create the release with:

```sh

git tag -s vx.x.x -m vx.x.x

git push origin vx.x.x

gh release create vx.x.x --generate-notes -t vx.x.x -d

```

where `vx.x.x` is the same `alfresco-content-services` Chart version.

Once the workflow triggered by this new tag is successful, review the GitHub release notes, usually

removing dependabot entries and other not-really useful changelog entries.

Publish the release (remove draft status).

Once the tagged workflow is successful, the release process is completed.