Creating the Repository

In our sandbox environment, we have an instance of Gitea, which is a self-hostable Git service. A user called gituser is already configured. Now we need to do a few things in the Gitea instance:

• Add an SSH key for the gituser user, to enable SSH as our Git transport.
• Create a repository for our configurations, with both prod and dev branches.

Setting Up SSH Access

For simplicity's sake, we have a pre-created SSH key to work with. But if you need to know how to create an SSH key for Git usage, GitHub has a good tutorial on it.

Setting up the SSH Transport

1. Click Gitea on the top nav.

2. Click Sign In at the top right corner, if the Sign In form does not already have focus.

3. Enter these credentials, then sign in (green button):

   Username	Password
   gituser	cribldemo

4. From the Profile menu at the top right corner, click Settings. (This is the colored Gravitar icon - )

5. On the resulting Settings page, click the SSH/GPG Keys tab.

6. Beside Manage SSH Keys, click the Add Key button.

7. Paste the following SSH public key into the Content field. (This will automatically fill the Key Name field with sandbox+gituser@cribl.io .)

   ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBEQv6jP+Etvhbz9MDt1BHt6bgXobVFTc2G6NA6Md7bNVRlqkqER07Gao7dq/l6EY5UzIBiaaGiw4+SkdPAYIJzQ= sandbox+gituser@cribl.io

8. Click the green Add Key button below the key you just pasted.

Your screen should now look something like this. Note the green confirmation message:

Creating the Git Repository

Now that we have our transport set up, we need to create a Git repository in which to store our configurations.

Create the Repository

1. Still on the Gitea top tab, pull down the + (Add) menu at the upper right, and select + New Repository.
2. On the resulting New Repository page, type stream-config into the Repository Name field, and click the Make Repository Private check box. (You can leave everything else as default.)
3. Click the Create Repository button at the bottom.
4. On the resulting Quick Guide page, beside Clone this repository, click the SSH button.
5. If you named the repository stream-config, you should now see git@gitops-gitea:gituser/stream-config.git in the adjacent field. (If you used a different name, you'll instead see a different value.) Either way, click the nearby Copy button to copy it to the clipboard for the next few steps.

Best Practice - Private Repositories

When you create your production repositories, follow the best practice of setting them up as private repositories. (Git services like GitHub or BitBucket will default to instead making your repos public, leaving them visible online.)

Your screen should now look something like this:

Our Git user and repository are now set up, so now we can get to configuring Stream.