Javier Jardón pushed to branch jennis/change_arch_install_instructions at BuildStream / buildstream
Commits:
-
289de2ef
by Adam Jones at 2018-08-07T09:24:58Z
-
e42325b9
by Javier Jardón at 2018-08-07T10:29:46Z
-
8c98cb73
by James Ennis at 2018-08-07T10:49:57Z
2 changed files:
Changes:
| ... | ... | @@ -143,6 +143,50 @@ Instance with push and requiring client authentication: |
| 143 | 143 |
|
| 144 | 144 |
bst-artifact-server --port 11002 --server-key server.key --server-cert server.crt --client-certs authorized.crt --enable-push /home/artifacts/artifacts
|
| 145 | 145 |
|
| 146 |
+Managing the cache with systemd
|
|
| 147 |
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
| 148 |
+ |
|
| 149 |
+It is better to run the cache as a systemd service, especially if it is running on a dedicated server, as this will allow systemd to manage the cache, incase the server ever encounters any issues.
|
|
| 150 |
+ |
|
| 151 |
+Below are two examples of how to run the cache server as a systemd service, one is for pull only and the other is configured for push & pull.
|
|
| 152 |
+ |
|
| 153 |
+.. code:: ini
|
|
| 154 |
+ |
|
| 155 |
+ #
|
|
| 156 |
+ # Pull
|
|
| 157 |
+ #
|
|
| 158 |
+ [Unit]
|
|
| 159 |
+ Description=Buildstream Artifact pull server
|
|
| 160 |
+ After=remote-fs.target network-online.target
|
|
| 161 |
+ |
|
| 162 |
+ [Service]
|
|
| 163 |
+ Environment="LC_ALL=C.UTF-8"
|
|
| 164 |
+ ExecStart=/usr/local/bin/bst-artifact-server --port 11001 --server-key {{certs_path}}/privkey.pem --
|
|
| 165 |
+ server-cert {{certs_path}}/fullchain.pem {{artifacts_path}}
|
|
| 166 |
+ User=artifacts
|
|
| 167 |
+ |
|
| 168 |
+ [Install]
|
|
| 169 |
+ WantedBy=multi-user.target
|
|
| 170 |
+ |
|
| 171 |
+ |
|
| 172 |
+ #
|
|
| 173 |
+ # Pull/Push
|
|
| 174 |
+ #
|
|
| 175 |
+ [Unit]
|
|
| 176 |
+ Description=Buildstream Artifact pull/push server
|
|
| 177 |
+ After=remote-fs.target network-online.target
|
|
| 178 |
+ |
|
| 179 |
+ [Service]
|
|
| 180 |
+ Environment="LC_ALL=C.UTF-8"
|
|
| 181 |
+ ExecStart=/usr/local/bin/bst-artifact-server --port 11002 --server-key {{certs_path}}/privkey.pem --
|
|
| 182 |
+ server-cert {{certs_path}}/fullchain.pem --client-certs /home/artifacts/authorized.crt --enable-push /
|
|
| 183 |
+ {{artifacts_path}}
|
|
| 184 |
+ User=artifacts
|
|
| 185 |
+ |
|
| 186 |
+ [Install]
|
|
| 187 |
+ WantedBy=multi-user.target
|
|
| 188 |
+ |
|
| 189 |
+Here we define when systemd should start the service, which is after the networking stack has been started, we then define how to run the cache with the desired configuration, under the artifacts user. The {{ }} are there to denote where you should change these files to point to your desired locations.
|
|
| 146 | 190 |
|
| 147 | 191 |
User configuration
|
| 148 | 192 |
~~~~~~~~~~~~~~~~~~
|
| ... | ... | @@ -57,9 +57,19 @@ Install the dependencies with:: |
| 57 | 57 |
For the default plugins::
|
| 58 | 58 |
|
| 59 | 59 |
sudo pacman -S \
|
| 60 |
- bzr git lzip ostree patch python-arpy python-gobject
|
|
| 60 |
+ bzr git lzip ostree patch python-gobject
|
|
| 61 | 61 |
|
| 62 | 62 |
|
| 63 |
+The package *python-arpy* is required by the deb source plugin. This is not
|
|
| 64 |
+obtainable via `pacman`, you must get *python-arpy* from AUR:
|
|
| 65 |
+https://aur.archlinux.org/packages/python-arpy/ .
|
|
| 66 |
+To install::
|
|
| 67 |
+ |
|
| 68 |
+ wget https://aur.archlinux.org/cgit/aur.git/snapshot/python-arpy.tar.gz
|
|
| 69 |
+ tar -xvf python-arpy.tar.gz
|
|
| 70 |
+ cd python-arpy
|
|
| 71 |
+ makepkg -si
|
|
| 72 |
+ |
|
| 63 | 73 |
Debian
|
| 64 | 74 |
++++++
|
| 65 | 75 |
Install the dependencies with::
|
| ... | ... | @@ -225,7 +235,7 @@ Fedora |
| 225 | 235 |
~~~~~~
|
| 226 | 236 |
|
| 227 | 237 |
BuildStream is not yet in the official Fedora repositories, but you can
|
| 228 |
-install it from a Copr:
|
|
| 238 |
+install it from a Copr::
|
|
| 229 | 239 |
|
| 230 | 240 |
sudo dnf copr enable bochecha/buildstream
|
| 231 | 241 |
sudo dnf install buildstream
|