Skip to content

Commit 5b68001

Browse files
authored
Update worker_vm.md
1 parent ae4a6a9 commit 5b68001

File tree

1 file changed

+9
-16
lines changed

1 file changed

+9
-16
lines changed

_docs/developer/getting_started/worker_vm.md

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -11,41 +11,34 @@ machines* in addition to your primary vagrant virtual machine.
1111

1212
## Automated Worker Installation
1313

14-
1. Make sure to destroy any existing worker machines before generating a new worker configuration.
15-
Failure to do this could result in 'hidden' worker machines from the previous configuration
16-
still running on your computer, taking up disk space and resources.
17-
```
18-
vagrant workers destroy
19-
```
14+
These instructions are intended to be followed after [configuring the main virtual machine](/developer/getting_started/vm_install_using_vagrant).
2015

21-
2. Ensure you have [Python 3](https://www.python.org/downloads/) installed on your machine.
16+
1. Ensure you have [Python 3](https://www.python.org/downloads/) installed on your machine.
2217
`python3 --version`
2318

24-
3. Generate configuration for the worker machine(s).
19+
2. Generate configuration for the worker machine(s).
2520
```
2621
vagrant workers generate
2722
```
28-
For multiple workers, use the `-n` flag. (ex. `-n 3` for 3 machines).
29-
30-
This command will generate workers for `virtualbox`, or `qemu` if you are on M-series macOS.
31-
If using a provider other than the default for your system, use the `--provider` flag.
32-
(ex. `--provider my-custom-provider`)
23+
For multiple workers, append the `-n` flag. (ex. `-n 3` for 3 machines).
3324

34-
5. If you are on MacOS running QEMU, make sure to restart the network socket.
25+
3. If you are on MacOS running QEMU, make sure to restart the network socket.
3526
```
3627
vagrant workers socket restart
3728
```
3829
If the VM runs into errors when attempting to reach the internet, try starting the socket
3930
in public mode. (`vagrant workers socket restart --public`)
31+
32+
__NOTE__: Never interact with the socket while a worker machine is running. This can make the machine inaccessible.
4033

4134
6. Now you can create the worker machine(s) with:
4235
```
4336
vagrant workers up
4437
```
4538
Do not use the --provider flag with this command, since it will conflict with the
46-
provider generated in step 3.
39+
provider of the main virtual machine.
4740

48-
7. Once all the workers are fully set up and running, `vagrant ssh` into the main VM and run:
41+
7. Once all the workers are fully set up and running, `vagrant ssh` into the main virtual machine and run:
4942
```
5043
refresh_vagrant_workers
5144
```

0 commit comments

Comments
 (0)