BUILDBOT-WORKER(1)

💖 BUILDBOT-WORKER(1) 💖

okay bestie, welcome to the User Commands section of the manual, page one, and this is the buildbot-worker glow-up tour 🌈✨

✨ NAME ✨

buildbot-worker — a tool for managing buildbot worker instances 🛠️🫶

🌸 SYNOPSIS 🌸

so here's the whole vibe in code form, no cap:

buildbot-worker [ global options ] command [ command options ]

buildbot-worker create-worker [ -q|--quiet ] [ -f|--force ] [ -r|--relocatable ] [ -n|--no-logrotate ] [ -k|--keepalive TIME ] [ --usepty {0|1} ] [ --umask UMASK ] [ -s|--log-size SIZE ] [ -l|--log-count COUNT ] [ --delete-leftover-dirs ] [ --verbose ] PATH MASTER USERNAME PASSWORD

buildbot-worker [ --verbose ] { start|stop|restart } [ PATH ]

buildbot-worker [ --verbose ] { --help|--version }

buildbot-worker command -h|--help

💅 DESCRIPTION 💅

the buildbot-worker command-line tool is literally the main character for starting or stopping a Buildbot worker, or creating a brand-new worker instance 💖 it's giving "I do one job and I ate" 👑

🎀 OPTIONS 🎀

🦋 Commands 🦋

these are the four moves, pick your fighter:

• create-worker — makes a directory and populates it for a fresh new worker 🐣
• start — starts a worker 🚀
• stop — stops a worker 🛑
• restart — restarts a worker 🔁

⭐ Global options ⭐

the universal levers, they work everywhere:

• -h, --help — prints the list of available commands and global options. warning bestie: every command after this one gets ignored, it's not listening anymore 🙈
• --version — prints the twistd and buildbot-worker version. also ignores everything that comes after it, same energy 💀
• --verbose — verbose output, i.e. it tells you everything 🗣️

🌸 create-worker command options 🌸

this is the big one, the deluxe menu, buckle up:

• -f, --force — re-use an existing directory, no questions asked 🫣
• -h, --help — show help for the current command and exit. yep, all subsequent commands get ignored 👋
• -k, --keepalive — sends keepalive requests to the buildmaster every TIME seconds. default is 600 seconds ⏱️
• -l, --log-count — limits the number of kept old twisted log files to COUNT. by default, all files are kept 📚
• -q, --quiet — does not emit the commands being run, shhh 🤫
• -r, --relocatable — creates a relocatable buildbot.tac 📦
• -n, --no-logrotate — does not permit the worker to rotate logs by itself 🚫🪵
• -s, --log-size — sets the size at which the twisted log file is rotated, in SIZE bytes. default is 1000000 bytes 📏
• --umask — sets the umask for files created by the worker. default is 077, which means only the owner can access the files 🔒 check out umask(2) for the full tea
• --usepty — sets whether child processes should be run in a pty (0 means do not run in a pty). default is 0 🖥️
• --delete-leftover-dirs — set this to remove unexpected directories in the worker base directory 🧹
• PATH — path to the worker base directory 📁
• MASTER — sets the host and port of the buildbot master to attach to, in the form HOST:PORT. this should be provided by the buildmaster administrator 👑
• USERNAME — the worker name to connect with. also provided by the buildmaster administrator 🫶
• PASSWORD — the worker password to connect with. yep, also from the buildmaster administrator 🔑 (don't lose it, and don't post it in the group chat)

💜 SEE ALSO 💜

• buildbot(1)
• umask(2)

and that's the whole page, periodt 💅 this was the Buildbot manual, dated August 2010 — yes, 2010, it's vintage, it's iconic, it's the blueprint 🕰️✨ go forth and spin up workers bestie, ily 🫶💖