Automated Versioning Manager (AVM)

Overview

The Automated Versioning Manager is a tool that helps manage Appian applications and database DDL files in a version control system. Given an Appian application ZIP file, the Automated Versioning Manager performs the following actions:

  • Unzips the application and organizes the artifact XML files in the repository.
  • Automates the check-in and check-out operations with the version control system.
  • Generates application packages for import in Appian based on the contents of the repository and a range of changes to include.

This tool is frequently used with the native, external deployment APIs (https://docs.appian.com/suite/help/22.1/Deployment_Rest_API.html) or the Automated Import Manager (AIM) (https://community.appian.com/w/the-appian-playbook/198/deployment-automation). Unless you are doing deployments for the Admin Console, we suggest using the native APIs.

Key Features & Functionality

  • Version Control integration (Git, SVN)
  • Supports Appian applications and packages
  • Generate import package from hash ranges
  • Folder Listener to add contents to Version Control
  • Supports GitHub, GitLab, and BitBucket for Version Control

You can access the source code for AVM by exploding the ZIP file after download.

Note: This utility does not support Java version 9.0. 

Anonymous
Parents Comment Children
  • I got the same error.
    The git repo I was working with had no files in it. So I created a simple README.MD file and pushed it to the git repo. The addContents action started to work for me then.

    1. Navigate to local repo directory
    2. Create README.MD file:

        For mac or linux run command: echo "This repo contains the Appian objects" > README.MD

        For Windows run command: notepad.exe README.MD then enter the text in the file and save the file

    3. Initialize the git if you haven't already with command: git init -b {branch name}

    4. Add the file you just created with: git add -A

    5. Commit the files with command: git commit -m "{your message here}"

    6. Set up the remote repo, if you haven't already done so: git remote add origin {http git url}

    7. Push the README.MD file to the repo: git push origin {your branch here}

    Then rerun the the AVM addContents command.

    Hope this helps.