Git Approval

caution

This is page is work in progress

Installation

The collector should be installed in such a way that it could connect to the Git server and that the personal user can connect from the browser to the collector service. More information can be found in the Approval Framework page.

Standalone

It is recommended to use the Kubernetes installation for production.

Prequisites

• Docker

Installation

docker run -d -p 8080:8080 --restart=unless-stopped \

-e "spring.profiles.active=GIT" \

-e "argos-collector.collectortypes.git.baseurl=https://github.com" \

--name git-collector argosnotary/argos-collector-service

Kubernetes

Prerequisites

• kubernetes: documentation
• helm3 3.1+: documentation

Installation

Add the argosnotary Helm repository

helm repo add argosnotary https://charts/argosnotary.com

helm repo update

Install Git Argos Collector

helm install git argosnotary/git-argos-collector \

--set "collector.type=GIT,collector.baseurl=https://github.com" \

--set ingress.hosts[0].host=git-collector.local,ingress.hosts[0].paths[0]="/"

Configuration

An approval in the Argos Notary Service, defined on a Supply Chain, has one or more collector definitions. One of these definitions could be a Git Collector.

Add an XL Deploy Approval

Add a XL Deploy Approval following these steps

1. In the Argos Notary Service go to the Supply Chain on which there should be an approval.
2. Right mouse button > choose Manage Layout

3. In the Layout Segment add a Step

4. Choose Approval Step

5. Choose Git

6. Fill in fields

• Choose a relevant name
• The Collector Service url is the url of the collector defined in the pervious installation step
• Repository path is the path from the Service url to the Git repository
• Save, and, after finishing the layout, sign and submit it to the Argos Notary Service

Approve

If the Functionary is a person and her or his key is one of the authorized keys on the step and has the add a link permission, this person can do an approval on the Supply Chain.

1. In the Argos Notary Service go to the Supply Chain on which there should be an approval defined.
2. Right mouse button > choose Approve step

3. Choose the approval

4. Choose based on what should be collected

• branch
• tag
• unique enough part of a commit hash

4. Fill in fields

• Username and password should be the Git credentials
• Fill in, based on previous choice, tag, branch or git commit hash

5. Add, optionally, more approvals with next
6. Approve and sign