docs: Cleanup setup-recommended.md.

For consistency, using `console` instead of `bash` to show commands to run, and dropping the name "christie" from examples.
This commit is contained in:
Robert Dyer 2024-03-12 14:13:59 -05:00 committed by Tim Abbott
parent e367718283
commit 32c8d89eeb
6 changed files with 64 additions and 76 deletions

View File

@ -93,7 +93,6 @@ Now you are ready for [Step 2: Get Zulip code](#step-2-get-zulip-code).
##### 1. Install Vagrant, Docker, and Git
```console
christie@ubuntu-desktop:~
$ sudo apt install vagrant docker.io git
```
@ -136,20 +135,20 @@ installation method described here. We require version 0.67.6+ of WSL 2.
1. Launch the Ubuntu shell as an administrator and run the following command:
```bash
sudo apt update && sudo apt upgrade
```console
$ sudo apt update && sudo apt upgrade
```
1. Install dependencies with the following command:
```bash
sudo apt install rabbitmq-server memcached redis-server postgresql
```console
$ sudo apt install rabbitmq-server memcached redis-server postgresql
```
1. Open `/etc/rabbitmq/rabbitmq-env.conf` using e.g.:
```bash
sudo nano /etc/rabbitmq/rabbitmq-env.conf
```console
$ sudo nano /etc/rabbitmq/rabbitmq-env.conf
```
Confirm the following lines are at the end of your file, and add
@ -163,10 +162,10 @@ installation method described here. We require version 0.67.6+ of WSL 2.
1. Run the command below to make sure you are inside the WSL disk and not
in a Windows mounted disk. You will run into permission issues if you
run `provision` from `zulip` in a Windows mounted disk.
run `./tools/provision` from `zulip` in a Windows mounted disk.
```bash
cd ~ # or cd /home/USERNAME
```console
$ cd ~ # or cd /home/USERNAME
```
1. [Create your fork](../git/cloning.md#step-1a-create-your-fork) of
@ -179,23 +178,23 @@ installation method described here. We require version 0.67.6+ of WSL 2.
1. Clone and connect to the Zulip upstream repository:
```bash
git clone --config pull.rebase git@github.com:YOURUSERNAME/zulip.git ~/zulip
cd zulip
git remote add -f upstream https://github.com/zulip/zulip.git
```console
$ git clone --config pull.rebase git@github.com:YOURUSERNAME/zulip.git ~/zulip
$ cd zulip
$ git remote add -f upstream https://github.com/zulip/zulip.git
```
1. Run the following to install the Zulip development environment and
start it. (If Windows Firewall creates popups to block services,
simply click **Allow access**.)
```bash
# Install/update the Zulip development environment
./tools/provision
# Enter the Zulip Python environment
source /srv/zulip-py3-venv/bin/activate
# Start the development server
./tools/run-dev
```console
$ # Install/update the Zulip development environment
$ ./tools/provision
$ # Enter the Zulip Python environment
$ source /srv/zulip-py3-venv/bin/activate
$ # Start the development server
$ ./tools/run-dev
```
1. If you are facing problems or you see error messages after running `./tools/run-dev`,
@ -206,8 +205,8 @@ installation method described here. We require version 0.67.6+ of WSL 2.
recommended for editing files when developing with WSL. When you
have it installed, you can run:
```bash
code .
```console
$ code .
```
to open VS Code connected to your WSL environment.
@ -232,10 +231,10 @@ WSL 2 can be uninstalled by following [Microsoft's documentation][uninstall-wsl]
[clone your fork of the Zulip repository](../git/cloning.md#step-1b-clone-to-your-machine) and
[connect the Zulip upstream repository](../git/cloning.md#step-1c-connect-your-fork-to-zulip-upstream):
```bash
git clone --config pull.rebase git@github.com:YOURUSERNAME/zulip.git
cd zulip
git remote add -f upstream https://github.com/zulip/zulip.git
```console
$ git clone --config pull.rebase git@github.com:YOURUSERNAME/zulip.git
$ cd zulip
$ git remote add -f upstream https://github.com/zulip/zulip.git
```
This will create a `zulip` directory and download the Zulip code into it.
@ -263,15 +262,15 @@ environment](#step-3-start-the-development-environment).
Change into the zulip directory and tell Vagrant to start the Zulip
development environment with `vagrant up`:
```bash
# On Windows:
cd zulip
vagrant plugin install vagrant-vbguest
vagrant up --provider=virtualbox
```console
$ # On Windows:
$ cd zulip
$ vagrant plugin install vagrant-vbguest
$ vagrant up --provider=virtualbox
# On macOS or Linux:
cd zulip
vagrant up --provider=docker
$ # On macOS or Linux:
$ cd zulip
$ vagrant up --provider=docker
```
:::{warning}
@ -436,9 +435,9 @@ was:
If this error starts happening unexpectedly, then just run:
```bash
vagrant halt
vagrant up
```console
$ vagrant halt
$ vagrant up
```
to reboot the guest. After this, you can do `vagrant provision` and
@ -467,8 +466,8 @@ When running `vagrant up` or `provision`, if you see the following error:
It means that your local apt repository has been corrupted, which can
usually be resolved by executing the command:
```bash
apt-get -f install
```console
$ apt-get -f install
```
#### ssh connection closed by remote host
@ -531,11 +530,9 @@ then print out the custom settings for this virtual machine with
`vboxmanage getextradata YOURVMNAME enumerate`:
```console
christie@win10 ~/zulip
$ vboxmanage list vms
"zulip_default_1462498139595_55484" {5a65199d-8afa-4265-b2f6-6b1f162f157d}
christie@win10 ~/zulip
$ vboxmanage getextradata zulip_default_1462498139595_55484 enumerate
Key: VBoxInternal2/SharedFoldersEnableSymlinksCreate/srv_zulip, Value: 1
Key: supported, Value: false
@ -549,8 +546,8 @@ If `vboxmanage enumerate` prints nothing, or shows a value of 0 for
VBoxInternal2/SharedFoldersEnableSymlinksCreate/srv_zulip, then enable
symbolic links by running this command in Terminal/Git BASH/Cygwin:
```bash
vboxmanage setextradata YOURVMNAME VBoxInternal2/SharedFoldersEnableSymlinksCreate/srv_zulip 1
```console
$ vboxmanage setextradata YOURVMNAME VBoxInternal2/SharedFoldersEnableSymlinksCreate/srv_zulip 1
```
The virtual machine needs to be shut down when you run this command.
@ -564,7 +561,6 @@ Virtualbox as the virtualization provider. You can fix this by
explicitly passing the virtualbox provider to `vagrant up`:
```console
christie@win10 ~/zulip
$ vagrant up --provide=virtualbox
```
@ -645,7 +641,7 @@ Once you've provisioned successfully, you'll get output like this:
```console
Zulip development environment setup succeeded!
(zulip-py3-venv) vagrant@vagrant-base-trusty-amd64:~/zulip$
(zulip-py3-venv) vagrant@vagrant:/srv/zulip$
```
If the `(zulip-py3-venv)` part is missing, this is because your
@ -714,8 +710,8 @@ the VirtualBox Guest Additions for Linux on Windows hosts. You can
check the running version of VirtualBox Guest Additions with this
command:
```bash
vagrant ssh -- 'sudo modinfo -F version vboxsf'
```console
$ vagrant ssh -- 'sudo modinfo -F version vboxsf'
```
The bug has not been fixed upstream as of this writing, but you may be
@ -729,10 +725,10 @@ VBOXADD_VERSION 5.2.44
Then run these commands (yes, reload is needed twice):
```bash
vagrant plugin install vagrant-vbguest
vagrant reload
vagrant reload --provision
```console
$ vagrant plugin install vagrant-vbguest
$ vagrant reload
$ vagrant reload --provision
```
### Specifying an Ubuntu mirror
@ -755,8 +751,8 @@ If you need to use a proxy server to access the Internet, you will
need to specify the proxy settings before running `vagrant up`.
First, install the Vagrant plugin `vagrant-proxyconf`:
```bash
vagrant plugin install vagrant-proxyconf
```console
$ vagrant plugin install vagrant-proxyconf
```
Then create `~/.zulip-vagrant-config` and add the following lines to

View File

@ -1,10 +1,9 @@
##### 2. Add yourself to the `docker` group:
```console
christie@ubuntu-desktop:~
$ sudo adduser $USER docker
Adding user `christie' to group `docker' ...
Adding user christie to group docker
Adding user `YOURUSERNAME' to group `docker' ...
Adding user YOURUSERNAME to group docker
Done.
```
@ -12,9 +11,8 @@ You will need to reboot for this change to take effect. If it worked,
you will see `docker` in your list of groups:
```console
christie@ubuntu-desktop:~
$ groups | grep docker
christie adm cdrom sudo dip plugdev lpadmin sambashare docker
YOURUSERNAME adm cdrom sudo dip plugdev lpadmin sambashare docker
```
##### 3. Make sure the Docker daemon is running:
@ -36,8 +34,8 @@ If the service is not running, you'll see `Active: inactive (dead)` on
the second line, and will need to enable and start the Docker service
using the following:
```bash
sudo systemctl unmask docker
sudo systemctl enable docker
sudo systemctl start docker
```console
$ sudo systemctl unmask docker
$ sudo systemctl enable docker
$ sudo systemctl start docker
```

View File

@ -14,13 +14,12 @@ KeyboardInterrupt
(zulip-py3-venv) vagrant@vagrant:/srv/zulip$ exit
logout
Connection to 127.0.0.1 closed.
christie@win10 ~/zulip
$
```
Now you can suspend the development environment:
```console
christie@win10 ~/zulip
$ vagrant suspend
==> default: Saving VM state and suspending execution...
```
@ -28,7 +27,6 @@ $ vagrant suspend
If `vagrant suspend` doesn't work, try `vagrant halt`:
```console
christie@win10 ~/zulip
$ vagrant halt
==> default: Attempting graceful shutdown of VM...
```

View File

@ -4,10 +4,8 @@ connect to the virtual machine with `vagrant ssh` and re-start the
Zulip server:
```console
christie@win10 ~/zulip
$ vagrant up
$ vagrant ssh
(zulip-py3-venv) vagrant@vagrant:/srv/zulip
$ ./tools/run-dev
(zulip-py3-venv) vagrant@vagrant:/srv/zulip$ ./tools/run-dev
```

View File

@ -1,8 +1,7 @@
Once `vagrant up` has completed, connect to the development
environment with `vagrant ssh`:
Once `vagrant up` has completed, connect to the development environment
with `vagrant ssh`:
```console
christie@win10 ~/zulip
$ vagrant ssh
```
@ -22,8 +21,7 @@ provisioning failed and you should look at the
Next, start the Zulip server:
```console
(zulip-py3-venv) vagrant@vagrant:/srv/zulip
$ ./tools/run-dev
(zulip-py3-venv) vagrant@vagrant:/srv/zulip$ ./tools/run-dev
```
You will see something like:

View File

@ -6,8 +6,8 @@ does the following:
- configures this virtual machine/container for use with Zulip,
- creates a shared directory mapping your clone of the Zulip code inside the
virtual machine/container at `~/zulip`
- runs the `tools/provision` script inside the virtual machine/container, which
downloads all required dependencies, sets up the python environment for
- runs the `./tools/provision` script inside the virtual machine/container, which
downloads all required dependencies, sets up the Python environment for
the Zulip development server, and initializes a default test
database. We call this process "provisioning", and it is documented
in some detail in our [dependencies documentation](/subsystems/dependencies.md).