...

Initial commit procedure

1. Ensure the DataStage project ISX file(s) you wish to commit are available on your machine.
2. Use your git Git client to clone the Bitbucket Cloud remote Git repository you will be checking into.  Ensure the current branch is develop.
3. Check whether the cloned Git repository has a datastage directory at the root.   Create it now if it does not existIf this doesn't exist create it now. This folder is mandatory in order for MettleCI's automated deployment function to operate correctly.
4. Check whether the cloned Git repository has a filesystem directory at the root.   Create it now if it does not existIf this doesn't exist create it now. This folder is mandatory in order for MettleCI's automated deployment function to operate correctly.
5. Navigate to the command shell folder and locate the mettleci.cmd file.
6. Run the command shell by executing either the mettleci or mettleci.cmd from the command line. This will start an interactive session, the current working directory does not matter.
7. Run the isx cut command to split the project ISX file(s) into a temporary directory, this step can be repeated multiple times if there is more than one ISX for a given project. Documentation of this command can be found here.
8. The cut ISX files will be dumped into your temporary directory in the following directory structure <ISX source engine name>/<ISX source project name>/<category name - recursive>/<Job Name>.isx
9. Copy all ISX files and directories from within the <source ISX project name> directory to the datastage directory of  your cloned Git repository.  The final Git repository directory structure should match datastage/<category name - recursive>/<job name>.isx
10. Use Git to add, commit and push all changes.  Look at Atlassian's Git tutorial for details
11. Verify the commit is visible in Bitbucket cloud and against the develop branch.

Note: This procedure will not generate preview images (of the Job on the DataStage Classic Designer client canvas) for the initial commits to Bitbucket Server.  Depending on the number of projects you need to complete, this process can easily be scripted.

...