epicsoft/azure-devops-backup repository overview

⁠Azure DevOps Backup

This Docker image is managed and kept up to date by epicsoft LLC⁠.

Docker image for creating Azure DevOps backup based on official Alpine image⁠.

• Base image: https://hub.docker.com/_/alpine⁠
• Dockerfile: https://gitlab.com/epicsoft-networks/azure-devops-backup/blob/main/Dockerfile⁠
• Repository: https://gitlab.com/epicsoft-networks/azure-devops-backup/tree/main⁠
• Container-Registry: https://gitlab.com/epicsoft-networks/azure-devops-backup/container_registry⁠
• Docker Hub: https://hub.docker.com/r/epicsoft/azure-devops-backup⁠

⁠Description

This Docker image creates Azure DevOps backup for projects.
Depending on the configuration, backup can be compressed with 7Zip⁠.
Docker Image for database backup based on official Alpine image⁠.

Features:

• Backup project work items
• Backup project repositories
• Backup project wikis
• Backup project pipelines
• Backup project service connections
• Backup project boards
• Backup project dashboards
• Backup organization security settings
• Compress and encrypt backup with 7Zip⁠

Backup direktory: /backup

⁠Versions

latest based on alpine:latest - build weekly

⁠Environment variables

• DEVOPS_ORGANIZATION Azure DevOps organization name required
• DEVOPS_PROJECT Azure DevOps project name required
• DEVOPS_TOKEN Azure DevOps personal access token required
• DEVOPS_BACKUP_WORKITEMS backup project work items (default: true)
• DEVOPS_BACKUP_REPOSITORIES backup project repositories (default: true)
• DEVOPS_BACKUP_WIKIS backup project wikis (default: true)
• DEVOPS_BACKUP_PIPELINES backup project pipelines (default: true)
• DEVOPS_BACKUP_SERVICE_CONNECTIONS backup project service connections (default: true)
• DEVOPS_BACKUP_BOARDS backup project boards (default: true)
• DEVOPS_BACKUP_DASHBOARDS backup project dashboards (default: true)
• DEVOPS_BACKUP_SECURITY_SETTINGS backup organization security settings (default: false)
• DEVOPS_LOG_DEBUG Show additional log message (default: false)
• DEVOPS_WARN_EXIT Cancel backup if a warning message appears (default: false)
• DEVOPS_ERROR_EXIT Cancel backup if a error message appears (default: false)
• COMPRESS_ENABLE enable compression of backup with 7-Zip (default: false)
• COMPRESS_OPTIONS 7-Zip arguments for compression (default: a -t7z -md=20 -m0=lzma2 -mx=9 -mmt=on -aoa)
• COMPRESS_ENCRYPTION_PASSWORD 7-Zip password for encryption (default: empty)

⁠Installed Alpine packages

Alpine packages are installed in the current image in the latest version - https://pkgs.alpinelinux.org/packages⁠

• bash
• curl
• git
• jq
• p7zip
• ca-certificates

⁠Examples

⁠Backup single project

docker run --rm \
  -e DEVOPS_ORGANIZATION=<ORGANIZATION NAME> \
  -e DEVOPS_PROJECT=<PROJECT NAME> \
  -e DEVOPS_TOKEN=<PERSONAL ACCESS TOKEN> \
  -v /tmp:backup:rw \
  epicsoft/azure-devops-backup:latest

⁠Backup project with organization security settings

docker run --rm \
  -e DEVOPS_ORGANIZATION=<ORGANIZATION NAME> \
  -e DEVOPS_PROJECT=<PROJECT NAME> \
  -e DEVOPS_TOKEN=<PERSONAL ACCESS TOKEN> \
  -e DEVOPS_BACKUP_SECURITY_SETTINGS=true \
  -v /tmp:backup:rw \
  epicsoft/azure-devops-backup:latest

⁠Backup single project and compress backup

docker run --rm \
  -e DEVOPS_ORGANIZATION=<ORGANIZATION NAME> \
  -e DEVOPS_PROJECT=<PROJECT NAME> \
  -e DEVOPS_TOKEN=<PERSONAL ACCESS TOKEN> \
  -e COMPRESS_ENABLE=true \
  -e COMPRESS_ENCRYPTION_PASSWORD='<COMPRESS-PASSWORD>' \
  -v /tmp:backup:rw \
  epicsoft/azure-devops-backup:latest

⁠License

MIT License see LICENSE⁠

Please note that the MIT license only applies to the files created by epicsoft LLC. Other software may be licensed under other licenses.