Commit 3ea8bc88 authored by Valentin Reis's avatar Valentin Reis
Browse files

Readme update

parent f8827aa9
Pipeline #8570 passed with stages
in 56 minutes and 29 seconds
...@@ -24,15 +24,34 @@ rolling dependency for continuous integration. ...@@ -24,15 +24,34 @@ rolling dependency for continuous integration.
get nix through your package manager or `curl https://nixos.org/nix/install | get nix through your package manager or `curl https://nixos.org/nix/install |
sh` sh`
## usage ## usage (reccomended)
talk to @vreis, or talk to @vreis, or:
use `argopkgs` as a channel: ```
$ git clone git@xgitlab.cels.anl.gov:argo/argopkgs.git
```
That local clone can be used to build components:
```
$ nix-build /path/to/argopkgs -A <packagename>
```
And install packages:
```
$ nix-env -f /path/to/argopkgs -iA <packagename>
```
It's reccomended you read `pkgs/default.nix` for a list of available packages.
## usage (old way - use as a channel)
You can also use `argopkgs` as a channel. It's not reccomended, because usage of `nix-env -i <packagename>` evaluates
all derivations to get their `name` attribute - which in the case of argopkgs involves cloning a few repositories.
``` ```
nix-channel --add https://xgitlab.cels.anl.gov/argo/argopkgs/-/archive/master/argopkgs-master.tar.gz argopkgs $ nix-channel --add https://xgitlab.cels.anl.gov/argo/argopkgs/-/archive/master/argopkgs-master.tar.gz argopkgs
nix-channel --update argopkgs $ nix-channel --update argopkgs
``` ```
which lets you install packages: which lets you install packages:
...@@ -55,7 +74,7 @@ $ nix-shell ~/.nix-defexpr/channels/argopkgs -A candle ...@@ -55,7 +74,7 @@ $ nix-shell ~/.nix-defexpr/channels/argopkgs -A candle
if your key is already on the runners, you can redeploy them with: if your key is already on the runners, you can redeploy them with:
``` ```
$ g clone git@xgitlab.cels.anl.gov:argo/argopkgs.git $ git clone git@xgitlab.cels.anl.gov:argo/argopkgs.git
$ cd argopkgs/deployments $ cd argopkgs/deployments
$ nix-shell $ nix-shell
[nix-shell]$ ./deploy-runners.sh [nix-shell]$ ./deploy-runners.sh
...@@ -63,7 +82,7 @@ $ nix-shell ...@@ -63,7 +82,7 @@ $ nix-shell
or reboot/restart their gitlab-runner daemon with: or reboot/restart their gitlab-runner daemon with:
``` ```
$ g clone git@xgitlab.cels.anl.gov:argo/argopkgs.git $ git clone git@xgitlab.cels.anl.gov:argo/argopkgs.git
$ cd argopkgs/deployments $ cd argopkgs/deployments
$ ./restart-runners.sh $ ./restart-runners.sh
$ ./reboot-runners.sh $ ./reboot-runners.sh
...@@ -75,8 +94,10 @@ these are deployed via NixOps: ...@@ -75,8 +94,10 @@ these are deployed via NixOps:
- defined in file [deployments/ci.nix](deployments/ci.nix) - defined in file [deployments/ci.nix](deployments/ci.nix)
- deployment state is in `deployments/argo.nixops`. - deployment state is in `deployments/argo.nixops`.
- there are four shell scripts in [deployments/](deployments/) that can be used to redeploy, reboot, and restart systemd services. - there are four shell scripts in [deployments/](deployments/) that can be used
- access is granted to all keys in [deployment/keys](deployment/keys) so submit a pull request and ask someone to redeploy if you need access. to redeploy, reboot, and restart systemd services.
- access is granted to all keys in [deployment/keys](deployment/keys) so submit
a pull request and ask someone to redeploy if you need access.
The gitlab-runner service is called "gitlabrunner" on the machines. That The gitlab-runner service is called "gitlabrunner" on the machines. That
systemd service registers runners on ExecStart and unregisters them on systemd service registers runners on ExecStart and unregisters them on
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment