tree: bb10751f4f693d60998345c948e1d0723dc5685e [path history] [tgz]
  1. src/
  2. .gitignore
  3. .sling-module.json
  4. bnd.bnd
  5. docker-env.sample
  6. Dockerfile
  7. Jenkinsfile
  8. pom.xml
  9. README.md
  10. run.sh
README.md

Apache Sling

Build Status Test Status Coverage Sonarcloud Status License

Apache Sling Committer CLI tool

This module is part of the Apache Sling project.

This module provides a command-line tool which automates various Sling development tasks. The tool is packaged as a docker image.

Configuration

To make various credentials and configurations available to the docker image it is recommended to use a docker env file. A sample file is stored at docker-env.sample. Copy this file to docker-env and fill in your own information.

Launching

The image is built using mvn package. Afterwards it may be run with

docker run --env-file=./docker-env apache/sling-cli

This invocation produces a list of available commands.

Commands

The commands can be executed in 3 different modes:

  • DRY_RUN (default mode) - commands only list their output without performing any actions on the user's behalf
  • INTERACTIVE - commands list their output but ask for user confirmation when it comes to performing an action on the user's behalf
  • AUTO - commands list their output and assume that all questions are provided the default answers when it comes to performing an action on the user's behalf

To select a non-default execution mode provide the mode as an argument to the command:

docker run -it --env-file=./docker-env apache/sling-cli release prepare-email --repository=$STAGING_REPOSITORY 
--execution-mode=INTERACTIVE

Note that for running commands in the INTERACTIVE mode you need to run the Docker container in interactive mode with a pseudo-tty attached (e.g. docker run -it ...).

Listing active releases

docker run --env-file=./docker-env apache/sling-cli release list

Generating a release vote email

docker run --env-file=./docker-env apache/sling-cli release prepare-email --repository=$STAGING_REPOSITORY_ID

Generating a release vote result email

docker run --env-file=./docker-env apache/sling-cli release tally-votes --repository=$STAGING_REPOSITORY_ID

Generating the website update (only diff for now)

docker run --env-file=docker-env apache/sling-cli release update-local-site --repository=$STAGING_REPOSITORY_ID

Assumptions

This tool assumes that the name of the staging repository matches the one of the version in Jira. For instance, the staging repositories are usually named Apache Sling Foo 1.2.0. It is then expected that the Jira version is named Foo 1.2.0. Otherwise the link between the staging repository and the Jira release can not be found.

It is allowed for staging repository names to have an RC suffix, which may include a number, so that RC, RC1, RC25 are all valid suffixes.