provs/README.md

134 lines
4.3 KiB
Markdown
Raw Normal View History

2022-02-25 16:03:55 +00:00
# provs
[![pipeline status](https://gitlab.com/domaindrivenarchitecture/provs/badges/master/pipeline.svg)](https://gitlab.com/domaindrivenarchitecture/provs/-/commits/master)
2022-02-25 16:03:55 +00:00
[<img src="https://domaindrivenarchitecture.org/img/delta-chat.svg" width=20 alt="DeltaChat"> chat over e-mail](mailto:buero@meissa-gmbh.de?subject=community-chat) | [<img src="https://meissa-gmbh.de/img/community/Mastodon_Logotype.svg" width=20 alt="team@social.meissa-gmbh.de"> team@social.meissa-gmbh.de](https://social.meissa-gmbh.de/@team) | [Website & Blog](https://domaindrivenarchitecture.org)
2022-02-25 16:03:55 +00:00
## Purpose
2022-08-21 12:00:00 +00:00
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.
2021-02-11 17:03:13 +00:00
2022-02-25 16:03:55 +00:00
## Status
2021-02-11 17:03:13 +00:00
2022-02-26 20:20:07 +00:00
under development - we are working hard on setting up our environments using provs.
2021-02-11 17:03:13 +00:00
2022-02-25 16:03:55 +00:00
## Try out
### Prerequisites
* A **Java Virtual machine** (JVM) is required.
2022-02-25 13:35:39 +00:00
* Install `jarwrapper` (e.g. `sudo apt install jarwrapper`)
2022-08-21 12:00:00 +00:00
* 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
2022-08-21 12:00:00 +00:00
After having installed `provs-desktop.jar` (see prerequisites) execute:
2022-02-25 13:35:39 +00:00
`provs-desktop.jar <type> <target> [<options>]`
2022-02-25 13:35:39 +00:00
**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)
2022-02-25 13:35:39 +00:00
**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
2022-02-25 13:35:39 +00:00
* 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
2022-02-25 13:35:39 +00:00
**options**
* `-p` for interactive password question
2022-04-01 20:31:56 +00:00
2022-08-21 12:00:00 +00:00
#### Example
2022-02-25 16:06:02 +00:00
```bash
2022-04-01 20:31:56 +00:00
provs-desktop.jar basic local
# or an office desktop remote:
provs-desktop.jar office myuser@myhost.com -p
2022-02-25 16:06:02 +00:00
```
2022-08-21 12:00:00 +00:00
In the second case you'll be prompted for the password of the remote user due to option `-p`.
2022-04-01 20:31:56 +00:00
2022-08-21 12:00:00 +00:00
### Provision a k3s Server
2022-02-25 13:35:39 +00:00
2022-02-25 16:06:02 +00:00
```bash
2022-04-01 20:31:56 +00:00
provs-server.jar k3s local
# or remote:
provs-server.jar k3s myuser@myhost.com # using ssh-authentication - alternatively use option -p for password authentication
2022-02-25 16:06:02 +00:00
```
2022-02-25 13:35:39 +00:00
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.
2022-05-08 18:43:56 +00:00
```yaml
fqdn: "myhostname.com"
node:
ipv4: "192.168.56.123" # ip address
2022-05-29 16:10:24 +00:00
echo: true # for demo reasons only - deploys an echo app
2022-05-11 07:57:24 +00:00
```
2022-05-08 18:43:56 +00:00
2022-05-11 07:57:24 +00:00
To add a grafana agent to your k3s installation add the following to the config:
```yaml
2022-05-08 18:43:56 +00:00
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
```
2022-05-11 07:57:24 +00:00
To provision the grafana agent only to an existing k8s system, ensure that the config (as above) is available and execute:
```bash
provs-server.jar k3s myuser@myhost.com -o grafana
```
2022-05-08 18:43:56 +00:00
2022-08-21 12:00:00 +00:00
### Perform a system check
2022-05-11 07:59:45 +00:00
The default config-file for the system check is `syspec-config.yaml`, you can specify a different file with option `-c <config-file>`.
2022-04-01 20:31:56 +00:00
```bash
provs-syspec.jar local
2022-08-21 12:00:00 +00:00
# or remote with a custom config filename
provs-syspec.jar myuser@myhost.com -c my-syspec-config.yaml
2022-04-01 20:31:56 +00:00
```
## Get help
To get help you can make use of the `-h` option:
```bash
2022-04-01 20:31:56 +00:00
provs-desktop.jar -h
provs-server.jar -h
provs-syspec.jar -h
```
2022-05-11 07:59:45 +00:00
2022-05-11 08:00:03 +00:00
Or to get help for subcommands e.g.
2022-05-11 07:59:45 +00:00
```bash
provs-desktop.jar ide -h
provs-server.jar k3s -h
```