Asymmetric-Effort/Bootstrap/Git-Server

(c) 2023 Sam Caldwell. See LICENSE.txt

Objective:

• MVP: Establish an internal git repository which is accessible via SSH using key-based authentication.

• ITERATION: Ensure that a user can view the code and other content of a git repository via HTTP for any repository in this internal git server.

• ITERATION: Implement githooks which will execute linters, build jobs and other automation.

• ITERATION: Implement HA replication and fail-over between svr00 and svr01.

Caveat:

• By default, data is stored at $(HOME)/git_server/ where home is the home directory of the user running the docker container

References

• see Git-SCM. This material is the source used to create this project, specifically chapter 4.

• The git-tools repository contains tools that make git-server easier to use with custom git scripts for git create, git use, git list and git delete.

Building Container

To build the container...

1. Clone this repo
2. Navigate to the directory
3. Run make git_server/build

To Run Local Container

To run this locally (e.g. bootstrapping an environment):

1. Build the container locally (see above).
2. Run make git_server/run_local

To Upload the Image

To upload the container image:

1. Build the container (see above)
2. Run make git_server/upload

Disclaimer: This currently is not implemented and by design it will only upload to my local docker hub.

Stop Services

To stop the git server, run make git_server/stop

Tailing logs of running services

To tail the logs, run make git_server/logs

Git-Shell Custom Commands

git authorize <key string>

Allow the user to add an ssh key to the ~/.ssh/authorized_keys file.

git authorized

Return the enumerated list of keys in ~/.ssh/authorized_keys.

git create <repo>

Create a new empty git repository

git delete <repo>

Delete a git repository

git help

Show help content

git list

List the repositories in the server

git proxy

Clone a remote repository to this server as a proxy

git push-proxy

Push changes in this server to the remote proxied repository

git rename

Rename a repository