Skip to content

Commit 8d2acf5

Browse files
authored
Update W2-cloud-box-and-preflight.md
1 parent f6808f8 commit 8d2acf5

1 file changed

Lines changed: 33 additions & 30 deletions

File tree

progression/W2-cloud-box-and-preflight.md

Lines changed: 33 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,13 @@
77
- [Objective](#objective)
88
- [Prereqs](#prereqs)
99
- [Context](#context)
10-
- [The cloud box (recommended)](#the-cloud-box-recommended)
11-
- [Running on your own machine (alternative)](#running-on-your-own-machine-alternative)
10+
- [Shared setup](#shared-setup)
1211
- [1. Clone the tutorial](#1-clone-the-tutorial)
1312
- [2. Install the pinned dependencies](#2-install-the-pinned-dependencies)
1413
- [3. Run preflight](#3-run-preflight)
15-
- [4. Sign in to GitHub](#4-sign-in-to-github)
14+
- [The cloud box (recommended)](#the-cloud-box-recommended)
15+
- [Running on your own machine (alternative)](#running-on-your-own-machine-alternative)
16+
- [1. Sign in to GitHub](#4-sign-in-to-github)
1617
- [Troubleshooting](#troubleshooting)
1718
- [What's next](#whats-next)
1819

@@ -31,32 +32,9 @@ Nothing in the rest of the curriculum works until the preflight check passes, an
3132

3233
Most participants should work on an instructor-provided cloud box, which is the path below. Your own machine works too, and that path is in the appendix at the end of this page. Do one of them, not both.
3334

34-
## The cloud box (recommended)
35-
36-
Getting onto the box is its own page. [`CLOUD_BOX_GUIDE.md`](../CLOUD_BOX_GUIDE.md) takes the four values your instructor sends you through to a running factory. Work through it first, then come back here for the preflight run below.
37-
38-
### Run preflight against the cloud box
39-
40-
**Copy and paste**
41-
42-
```bash
43-
sfbox preflight
44-
```
35+
## Shared setup
4536

46-
**Expected output**
47-
48-
```text
49-
==> Checking 'factory-cloud-aborn-2' (ubuntu@34.200.237.69) ...
50-
==> ssh reachable
51-
==> gc installed
52-
==> gas-city.service inactive — no city on this box yet
53-
==> Nothing is broken. This box supplies the environment and you build the
54-
==> city yourself, so the service stays down until there is one to run.
55-
```
56-
57-
## Running on your own machine (alternative)
58-
59-
Everything below is the fallback if you would like to run the curriculum on your local machine. If you are on an instructor-provided cloud box, skip to [What's next](#whats-next).
37+
Regardless of whether you choose to run the factory in our instructor-provided cloud box or your local machine, you will need to have gas city dependencies installed locally to build the factory packs and run checks correctly.
6038

6139
### 1. Clone the tutorial
6240

@@ -95,7 +73,7 @@ bd version 1.1.0 (8e4e59d39)
9573
dolt version 2.2.2
9674
```
9775

98-
Do what that last line says if you have not already:
76+
Export the `$PATH` variable for the local `gc` runtime:
9977

10078
```bash
10179
export PATH="$HOME/.local/bin:$PATH"
@@ -159,7 +137,32 @@ Local path
159137
PREFLIGHT: PASS
160138
```
161139

162-
### 4. Sign in to GitHub
140+
## The cloud box (recommended)
141+
142+
Follow [`CLOUD_BOX_GUIDE.md`](../CLOUD_BOX_GUIDE.md) from here once you have cloud box credentials from the instructor.
143+
144+
### Run preflight locally once complete
145+
146+
**Copy and paste**
147+
148+
```bash
149+
sfbox preflight
150+
```
151+
152+
**Expected output**
153+
154+
```text
155+
==> Checking 'factory-cloud-aborn-2' (ubuntu@34.200.237.69) ...
156+
==> ssh reachable
157+
==> gc installed
158+
==> gas-city.service inactive — no city on this box yet
159+
==> Nothing is broken. This box supplies the environment and you build the
160+
==> city yourself, so the service stays down until there is one to run.
161+
```
162+
163+
## Running on your own machine (alternative)
164+
165+
### 1. Sign in to GitHub
163166

164167
If you are not currently logged into GitHub, you will need to grant your software factory access to configure repos and push code.`gh auth login`, picking HTTPS, is the shortest route to login if necessary. It opens a browser and authorizes the GitHub CLI against your whole account.
165168

0 commit comments

Comments
 (0)