meissa/provs
7
1
Fork 0
Code Issues Pull requests Projects Releases 12 Packages Wiki Activity

[skip-ci] Update readme

Browse source
This commit is contained in:
erik 2022-09-07 14:15:07 +02:00
parent 503ca3dee4
commit 70b5dda4a7
1 changed files with 19 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
README.md
View file

@ -14,7 +14,7 @@ Tasks can be run locally or remotely.
## Status ## Status
under development - we are working hard on setting up our environments using provs. under development - though we already set up a few IDEs and servers with provs.
## Try out ## Try out
### Prerequisites ### Prerequisites
@ -57,24 +57,28 @@ After having installed `provs-desktop.jar` (see prerequisites) execute:
**options** **options**
* `-p` for interactive password question * `-p` for interactive password question
* `-o` for only executing one action, e.g.
* `-o verify` for verifying your installation
* `-o firefox` to install firefox from apt on ubuntu
* `-o teams` to install MS-Teams
#### Example #### Example
```bash ```bash
provs-desktop.jar basic local provs-desktop.jar basic local # installs a basic desktop on a local machine
# or an office desktop remote: provs-desktop.jar office myuser@myhost.com -p # installs an office desktop on a remote machine, prompting for password
provs-desktop.jar office myuser@myhost.com -p provs-desktop.jar ide myuser@myhost.com # installs an ide on a local machine
provs-desktop.jar ide myuser@myhost.com -o firefox # installs firefox on a remote machine
provs-desktop.jar ide myuser@myhost.com -o verify # verifies the installation on a remote machine
``` ```
In the second case you'll be prompted for the password of the remote user due to option `-p`.
### Provision a k3s Server ### Provision a k3s Server
```bash ```bash
provs-server.jar k3s local provs-server.jar k3s local # installs a k3s server locally
# or remote: provs-server.jar k3s myuser@myhost.com # install remote k3s using ssh-authentication // option -p for password authentication
provs-server.jar k3s myuser@myhost.com # using ssh-authentication - alternatively use option -p for password authentication provs-server.jar k3s myuser@myhost.com -c path/to/k3sServerConfig.yaml -a path/to/application.yaml # as above, but define paths to your application and config yamls
``` ```
For the remote server please configure a config file (default file name: server-config.yaml). For the remote server please configure a config file (default file name: server-config.yaml).
@ -103,7 +107,13 @@ To provision the grafana agent only to an existing k8s system, ensure that the c
provs-server.jar k3s myuser@myhost.com -o grafana provs-server.jar k3s myuser@myhost.com -o grafana
``` ```
Reprovisioning the server can easily be done using the -r or --reprovision option.
```bash
provs-server.jar k3s myuser@myhost.com -c path/to/k3sServerConfig.yaml -a path/to/application.yaml -r #
```
Or you can add `reprovision: true` to your k3sServerConfig.yaml.
### Perform a system check ### Perform a system check