Features

This crate can clone & manage git repositories in name of defined users on target systems. Features are:

clone repositories from various git providers
configure users global git settings like signing key, name or email
establish trust to repository servers
auto-sync (pull & push) repositories using cron
support ssh, https public, https user/password transport
reconfigure origin remote url of existing repositories

Usage Summary

Download the jar-file from the releases page of this repository (e.g. curl -L -o dda-git-crate.jar https://github.com/DomainDrivenArchitecture/dda-git-crate/releases/download/2.1.0/dda-git-crate-2.1.0-standalone.jar).
Create the files git.edn (Domain-Schema for your desktop) and target.edn (Schema for Targets to be provisioned) according to the reference and our example configurations. Please create them in the same folder where you've saved the jar-file. For more information about these files refer to the corresponding information below.
Start the installation:

java -jar dda-git-crate.jar --targets targets.edn git.edn

Detailed How-to

You can find a more detailed howto here: https://domaindrivenarchitecture.org/posts/2017-07-28-compose-crates/

Configuration

The configuration consists of two files defining both WHERE to install the software and WHAT to install.

targets.edn: describes on which target system(s) the software will be installed
git.edn: describes which repositories will be installed

You can download examples of these configuration files from
example-targets.edn and
example-serverspec.edn respectively.

Targets config example

Example content of file targets.edn:

{:existing [{:node-name "test-vm1"            ; semantic name
             :node-ip "35.157.19.218"}]       ; the ip4 address of the machine to be provisioned
 :provisioning-user {:login "initial"         ; account used to provision
                     :password
                     {:plain "secure1234"}}} ; optional password, if no ssh key is authorized

Git config example

Example content of file git.edn:

{:initial
 {:user-email "initial@some-domain.org"
  :repo  {:books
          [{:host "github.com"
            :orga-path "DomainDrivenArchitecture"
            :repo-name "ddaArchitecture"
            :protocol :https
            :server-type :github}]
          :dda-pallet
          [{:host "github.com"
            :orga-path "DomainDrivenArchitecture"
            :repo-name "dda-serverspec-crate"
            :protocol :https
            :server-type :github}
  :synced-repo  {:password-store
                 [{:host "github.com"
                   :orga-path "DomainDrivenArchitecture"
                   :repo-name "password-store-for-teams"
                   :protocol :https
                   :server-type :github}]}}}

If you want to clone your repositories with https from a private git server, you need to add your credentials to your git.edn file. You also need to add a :port, if it differs from 22 or 443. For example:

{:initial
 {:user-email "initial@some-domain.org"
  :credential [{:user-name {:plain "initial"}
                :password {:plain "githubpassword"}
                :host "gitserver.de"
                :port 123
                :protocol :https}]}}

Watch log for debug reasons

In case any problems occur, you may want to have a look at the log-file: less logs/pallet.log

Reference

Some details about the architecture: We provide two levels of API.

Domain-Level-API: Domain is a high-level API with many build in conventions.
Infra-Level-API:: If this conventions don't fit your needs, you can use our low-level infra API and realize your own conventions.