No description
Find a file
2022-09-01 20:49:28 +02:00
.idea-configs refactor: *.k3s -> server 2022-01-18 20:10:18 +01:00
.run rename IntelliJ test tasks 2022-06-10 12:53:01 +02:00
doc Arch-Workshop 2022-07-08 16:15:10 +02:00
gradle/wrapper v0.8.33-SNAPSHOT - upd deps, fix fatJar Main class 2021-12-27 22:18:55 +01:00
src add spec for s3 objects to syspec 2022-09-01 20:49:28 +02:00
.gitignore add syspec 2022-03-25 15:21:11 +01:00
.gitlab-ci.yml release-0.9.18 - add pipeline artifacts for syspec 2022-03-26 12:07:16 +01:00
build.gradle add spec for s3 objects to syspec 2022-09-01 20:49:28 +02:00
desktop-config-example.yaml release-0.11.10 - rename workplace to desktop 2022-06-16 22:57:08 +02:00
Dockerfile add Dockerfile 2021-02-25 20:11:00 +01:00
gradle.properties run container tests in ci 2021-02-25 19:57:06 +01:00
gradlew initial commit 2021-02-10 20:24:43 +01:00
gradlew.bat initial commit 2021-02-10 20:24:43 +01:00
LICENSE update README.md 2021-02-11 18:03:13 +01:00
README.md [skip-ci] Update README and gopass versions 2022-08-25 16:15:50 +02:00
settings.gradle correct maven name to provs 2021-08-07 19:14:12 +02:00

provs

pipeline status

DeltaChat chat over e-mail | team@social.meissa-gmbh.de team@social.meissa-gmbh.de | Website & Blog

Purpose

provs provides cli-based tools for

  • provisioning a desktop (various kinds)
  • provisioning a k3s server
  • performing system checks

Tasks can be run locally or remotely.

Status

under development - we are working hard on setting up our environments using provs.

Try out

Prerequisites

  • A Java Virtual machine (JVM) is required.
  • Install jarwrapper (e.g. sudo apt install jarwrapper)
  • Then either download the binaries or build them yourself

Download the binaries

  • Download the latest provs-desktop.jar,provs-server.jar and/or provs-syspec.jar from: https://gitlab.com/domaindrivenarchitecture/provs/-/releases
    • Preferably into /usr/local/bin or any other folder where executables can be found by the system
  • Make the jar-file executable e.g. by chmod +x provs-desktop.jar

Build the binaries

Instead of downloading the binaries you can build them yourself

  • Clone this repository
  • In the repository's root folder execute: ./gradlew install. This will install the binaries in /usr/local/bin

Provision a desktop

After having installed provs-desktop.jar (see prerequisites) execute:

provs-desktop.jar <type> <target> [<options>]

type can be:

  • basic - install some basic packages)
  • office - install office software (LibreOffice), E-Mail (Thunderbird), etc
  • ide - same as office with additionally ide-software (VSCode, IntelliJ, etc)

target can be:

  • local
  • remote, e.g. user123:mypassword@myhost.com - general format is: <user[:password]@host> -
    • be sure to have openssh-server installed
    • add your preferred public key to known_hosts on the target machine
    • if password is omitted, then ssh-keys will be used for authentication
    • if password is omitted but option -p is provided, then the password will be prompted interactively

options

  • -p for interactive password question

Example

provs-desktop.jar basic local
# or an office desktop remote:
provs-desktop.jar office myuser@myhost.com -p

In the second case you'll be prompted for the password of the remote user due to option -p.

Provision a k3s Server

provs-server.jar k3s local
# or remote: 
provs-server.jar k3s myuser@myhost.com    # using ssh-authentication - alternatively use option -p for password authentication

For the remote server please configure a config file (default file name: server-config.yaml). It has to be in the same folder where you execute the provs-server.jar command.

fqdn: "myhostname.com"
node:
  ipv4: "192.168.56.123"   # ip address
echo: true                 # for demo reasons only - deploys an echo app 

To add a grafana agent to your k3s installation add the following to the config:

grafana:
  user: "myusername"   # username for the grafana data source 
  password:
    source: "PLAIN"           # PLAIN, GOPASS or PROMPT
    parameter: "mypassword"   # the password or api key for the grafana data source user 
  cluster: "mycluster"        # a cluster name of your choice  

To provision the grafana agent only to an existing k8s system, ensure that the config (as above) is available and execute:

provs-server.jar k3s myuser@myhost.com -o grafana

Perform a system check

The default config-file for the system check is syspec-config.yaml, you can specify a different file with option -c <config-file>.

provs-syspec.jar local 
# or remote with a custom config filename
provs-syspec.jar myuser@myhost.com -c my-syspec-config.yaml

Get help

To get help you can make use of the -h option:

provs-desktop.jar -h
provs-server.jar -h
provs-syspec.jar -h

Or to get help for subcommands e.g.

provs-desktop.jar ide -h
provs-server.jar k3s -h