Server Guide#
Bootstrap a Server#
Unless otherwise required all machines operated by the PSF Salt infrastructure
should be running Ubuntu 14.04 and they will have their configuration managed by
psf-salt. Each machine should be given a hostname which matches the pattern
serviceN.dc.psf.io
where serviceN
is replaced by a service name (such as
pg
) and a unique number, and dc
is replaced by the PSF DC identifier for the DC that this machine is
in. A full example would be pg0.iad1.psf.io
. You’ll need to add this
hostname to pillar/prod/roles.sls
and pillar/dev/roles.sls
to put the
machine in the correct configuration nodegroup.
Once you have a machine, you can bootstrap it by simply executing
inv salt.bootstrap <public address>
. This will SSH into the machine,
install all the required software, register it with the salt master and run
highstate on it. Within 15 minutes the salt master will also setup the DNS
for the machine and it will live at the hostname that you have given it at
the psf.io domain.