...

• The setup of a local repository is explained with in the following chapterssections.
• Git access includes to authenticate authentication with a Git Server and to access accessing remote repositories , see as described in JS7 - How to set up Git Access.

The steps to set up a local Git repository can be applied manually from the JOC Cockpit or from a Git Client and they can be applied by use of the JS7 REST Web Service API.

...

Setup using JOC Cockpit

The steps to set for setting up a local Git repository are explained with in the JS7 - Inventory Git Integration, chapter: Clone Git Repository article.

...

The below example assumes that that:

• a top-level folder Accounting is used in the JOC Cockpit inventory,
• this folder is mapped to a sub-directory in the file system with the same name in the file system,
• this folder is created when setting up the repository otherwise it will be created by the JOC Cockpit the first time that objects should are to be stored to the repository.

There are a number of ways how to achieve of achieving this with a Git Client:

# Navigate to the repository sub-directory managed by JOC Cockpit
cd /var/sos-berlin.com/js7/joc/jetty_base/resources/joc/repositories/rollout/Accounting

# Run Git commands
git init
git branch -M main
git remote add origin git@github.com:sos-berlin/js7-demo-inventory-rollout-test.git
git push -u origin main

Automation with the JS7 REST Web Service API

Users who whish wish to automate the steps required to set up a local Git repository can use the following resources:

• The JS7 - REST Web Service API allows to perform the same operations for Git integration as offered from the JOC Cockpit GUI.
  • See Technical Documentation of the REST Web Service API
• The JS7 - PowerShell Module offers simplified access to the REST Web Service API for scripting purposes.
  • The Execution of the PowerShell examples when executed with the -debug option might prove to be instructive for logging of REST API calls when used with the -debug option.

Find the The documentation for related cmdlets from the relevant cmdlets is available in the PowerShell CLI 2.0 - Cmdlets - Git Repository Integration article.

The example below example assumes that that:

• a top-level Accounting folder Accounting is used in the JOC Cockpit inventory:
  • the folder will be used if it exists,
  • the folder will be created if it doesn't exist.
• the folder is mapped to a sub-directory with the same name in the file system,

...

• Line 2-3: The JS7 PowerShell Module is loaded and the connection to the JOC Cockpit is established, see JS7 - How to connect to JOC Cockpit using the PowerShell Module.
• Line 6: The Invoke-JS7GitRepositoryClone cmdlet is used. The Git repository URL is explained with in the JS7 - Inventory Git Integration, chapter: Clone Git Repository article.
• Line 9: The connection to JOC Cockpit is closed.

...