certusone
/
xdapp-book
mirror of https://github.com/certusone/xdapp-book.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update linux.md 

Updated copy and formatting for clarity.
This commit is contained in:
Ian Traas 2022-09-05 19:23:10 -05:00 committed by GitHub
parent a6701ed3c4
commit 684c010ddd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
src/development/tilt/linux.md
View File

@ -1,7 +1,7 @@
# Linux Devnet Setup # Linux Devnet Setup
### Experimental Setup Script ### Experimental Setup Script
There's an experimental one command setup script that should install dependencies for you on Linux and configure everything properly. This is only recommended if you're running headless Linux and unable to use Docker Desktop, as with Docker Desktop you don't need `minikube` and can just enable Kubernetes from Docker. There's an experimental single command setup script that should install dependencies for you on Linux and configure everything properly. This is only recommended if you're running headless Linux and unable to use Docker Desktop, as you can enable Kubernetes from Docker.
```sh ```sh
curl $URL | sh install_linux.sh curl $URL | sh install_linux.sh
@ -12,25 +12,30 @@ cd wormhole/
## Regular Setup ## Regular Setup
### 1. Install Go ### 1. Install Go
```sh ```sh
wget https://go.dev/dl/go1.18.1.linux-amd64.tar.gz wget https://go.dev/dl/go1.18.1.linux-amd64.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.1.linux-amd64.tar.gz rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.1.linux-amd64.tar.gz
``` ```
### 2. Install Docker ### 2. Install Docker
If you're using Linux with a window manager, consider getting Docker Desktop instead of the following command. It comes with Kubernetes built in and you won't need to download `minikube`. It's recommended to have at least 4 CPUs and 16GB RAM dedicated to Docker. If you're using Linux with a window manager, consider getting Docker Desktop instead of the following command. It comes with Kubernetes built in and you won't need to download `minikube`. It's recommended to have at least 4 CPUs and 16GB RAM dedicated to Docker.
Also make sure that you set up docker as a NON ROOT USER! Also, make absolutely sure that you set up Docker as a non-root user.
[https://docs.docker.com/engine/install/ubuntu/#installation-methods](https://docs.docker.com/engine/install/ubuntu/#installation-methods) [https://docs.docker.com/engine/install/ubuntu/#installation-methods](https://docs.docker.com/engine/install/ubuntu/#installation-methods)
### 3. (Docker Desktop Install) ### 3. (Docker Desktop Install)
Enable Kubernetes by going into Settings > Kubernetes Enable Kubernetes by going into Settings > Kubernetes
### 3. (Non Docker Desktop) ### 3. (Non Docker Desktop)
Install [`minikube`](https://minikube.sigs.k8s.io/docs/start/)
Configure minikube Install [`minikube`](https://minikube.sigs.k8s.io/docs/start/).
Configure minikube:
``` ```
minikube start --driver=docker --kubernetes-version=v1.23.3 --cpus=4 --memory=14G --disk-size=10G --namespace=wormhole minikube start --driver=docker --kubernetes-version=v1.23.3 --cpus=4 --memory=14G --disk-size=10G --namespace=wormhole
``` ```
@ -39,7 +44,8 @@ If you reboot your VM you'll need to run the `minikube start` command again befo
### 4. Install Tilt ### 4. Install Tilt
Install tilt by copy pasting this into the Terminal Install Tilt by copy pasting this into the Terminal:
```sh ```sh
curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/install.sh | bash
``` ```
@ -50,13 +56,14 @@ curl -fsSL https://raw.githubusercontent.com/tilt-dev/tilt/master/scripts/instal
git clone --branch dev.v2 https://github.com/certusone/wormhole.git git clone --branch dev.v2 https://github.com/certusone/wormhole.git
``` ```
If you're running tilt on your machine If you're running Tilt on your machine:
```sh ```sh
cd wormhole/ cd wormhole/
tilt up tilt up
``` ```
If you're running tilt in a VM, we need to pass in some extra flags to enable Tilt to listen to incoming traffic from external addresses. If you're running Tilt in a VM, you'll need to pass in some extra flags to enable Tilt to listen to incoming traffic from external addresses:
```sh ```sh
cd wormhole cd wormhole