Git Integration

NetOrca is designed to be consumed via a git repository, whilst requests can be sent directly to NetOrca, it is not recommended.

Git is the best way for teams to manage their ServiceItems and provides inbuilt logging of changes and approvals.

In addition the CI/CD processes included with NetOrca allow for the use of any common CI/CD runner to push changes to NetOrca, whilst both ensuring that ServiceItems have been requested correctly and that they have been accepted by NetOrca.

Create an API Key

API Key as used as the authentication methodology for all communications between the CI/CD process and NetOrca, this is more secure than using a username/password combination and allows the team to remove the api key access at any time if this is compromised.

Creation process described here

Initialise Git Repository

Whilst it is possible to have NetOrca ServiceItem definitions within an existing repository for an application, we recommend that this be put into a seperated application. This is mainly to allow for separation of applications builds to the infrastructure requests.

Create Repository

In your preferred GIT tool, create a new git repository.

Within that repo create a folder called '.netorca'

This folder will contain all of the netorca related configuration.

An example of a git repository that can be cloned for your set up is here: put an example repo here