Project Structure and Navigation Through the Tutorial Steps

1. Go to your project working folder, e.g. CommandCentralProjects, and checkout the tutorial git repository. To do this, open your Git command window and type:

git clone --recursive https://github.com/SoftwareAG/sagdevops-template-dev-guide.git tutorial
cd tutorial

This command will check out the tutorial project which looks like this:

build.xml
antcc/
environments/
  default/
    env.properties
templates/
   tutorial/
     template.yaml

The project uses the antcc library and follows its default layout. This significantly simplifies composite template development by reducing the number of steps needed to upload, run and check the execution status of a composite template job.

The tutorial for composite templates can be found in templates/tutorial/template.yaml file.

The environment/default/env.properties file is a set of default input parameters inputs for the composite template application.

2. Verify installed tools by running ant command to get short usage help from the antcc library:

[user@linuxbox tutorial]$ ant -p
Buildfile: /home/user/...

Main targets:
 agent      Bootstrap local SPM agent
 all        End to end automation
 apply      Apply template and wait
 backup     Backup local Command Central
 boot       Bootstrap local Command Central
 build      Build project assets
 clean      Clean project from build artifacts
 client     Bootstrap local CC CLI tool
 help       Usage help
 ...

3. The project relies on multiple git branches to navigate through the steps of the tutorial. Type the following to see the tutorial git branches:

[user@linuxbox tutorial]$ git branch -r
  origin/HEAD -> origin/stage-00
  origin/stage-00
  origin/stage-01
  origin/stage-02a
  origin/stage-02b
  origin/stage-03
  origin/stage-04
  origin/stage-05
  origin/stage-06
  origin/stage-07
  origin/stage-08a
  origin/stage-08b
  origin/stage-09a
  origin/stage-09b

You should be on the initial stage-00.

You can now begin your composite template development.