aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristopher Baines <mail@cbaines.net>2020-04-17 13:29:39 +0100
committerChristopher Baines <mail@cbaines.net>2020-04-17 13:29:39 +0100
commit78287e9cc4a8c8f000ccb6e6e5641180274e0e8e (patch)
treef6975c25895ddba23a9fba407fdc747474d48ad8
parentad6821d5c82010f299258560631c9a492e7e65e7 (diff)
downloadbuild-coordinator-78287e9cc4a8c8f000ccb6e6e5641180274e0e8e.tar
build-coordinator-78287e9cc4a8c8f000ccb6e6e5641180274e0e8e.tar.gz
Wrap the README commands in source blocks
-rw-r--r--README.org16
1 files changed, 16 insertions, 0 deletions
diff --git a/README.org b/README.org
index 251b9da..afb39cb 100644
--- a/README.org
+++ b/README.org
@@ -17,34 +17,46 @@ All the following commands should be run from the root of the Git
repository. Either use direnv to manage the environment, or run guix
environment to setup the environment.
+#+BEGIN_SRC sh
guix environment -l guix-dev.scm
export PATH="$PWD/scripts:$PATH"
+#+END_SRC
If you haven't yet done so, run the following commands to get the repository
setup to run the software.
+#+BEGIN_SRC sh
./bootstrap.sh
./configure
make
+#+END_SRC
Run guix-build-coordinator to start the coordinator process. By default, this
will use sqitch to create the guix_build_coordinator.db SQLite database file,
as well as sqitch.db which contains metadata about the database state.
+#+BEGIN_SRC sh
guix-build-coordinator
+#+END_SRC
In another terminal, run the following commands also at the root of the
repository to setup an agent process.
+#+BEGIN_SRC sh
guix-build-coordinator agent new
+#+END_SRC
Note the UUID of the generated agent.
+#+BEGIN_SRC sh
guix-build-coordinator agent <AGENT ID> password new
+#+END_SRC
Note the generated password for the agent.
+#+BEGIN_SRC sh
guix-build-coordinator-agent --uuid=<AGENT ID> --password=<AGENT PASSWORD>
+#+END_SRC
At this point, both processes should be running and the guix-build-coordinator
should be logging requests from the agent.
@@ -52,11 +64,15 @@ should be logging requests from the agent.
In a third terminal, also at the root of the repository, generate a
derivation, and then instruct the coordinator to have it built.
+#+BEGIN_SRC sh
guix build --no-grafts -d hello
+#+END_SRC
Note the derivation that is output.
+#+BEGIN_SRC sh
guix-build-coordinator build <DERIVATION FILE>
+#+END_SRC
This will return a randomly generated UUID that represents the build. If
everything works, the agent will setup and perform the build, and then the