bootstrapswarm

Documentation

Overview

bootstapswarm will bootstrap the swarming bot depending on the environment that it is run on.

On GCE: bootstrapswarm will retrieve authentication credentials from the GCE metadata service and use those credentials to download the swarming bot. It will then start the swarming bot in a directory within the user's home directory.

Requirements: - Python3 installed and in the calling user's PATH.

Not on GCE: bootstrapswarm will read the token file and retrieve the the luci machine token. It will use that token to authenticate and download the swarming bot. It will then start the swarming bot in a directory within the user's home directory.

Requirements:

• Python3 installed and in the calling user's PATH.
• luci_machine_tokend running as root in a cron job. See https://chromium.googlesource.com/infra/luci/luci-go/+/main/tokenserver. Further instructions can be found at https://go.dev/wiki/DashboardBuilders. The default locations for the token files should be used if possible: Most OS: /var/lib/luci_machine_tokend/token.json Windows: C:\luci_machine_tokend\token.json A custom default location can be set via the environment variable LUCI_MACHINE_TOKEN.
• bootstrapswarm should not be run as a privileged user.