Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 2 additions & 4 deletions .github/workflows/upload-assets.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,13 @@ jobs:
- run: yarn install
- name: Build for Nexus
run: SHA=${{ github.sha }} yarn build-for-nexus
- name: Gzip individual files (keep originals)
run: ls dist/assets/*.{js,css,map} | xargs gzip --keep

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I love xargs

- run: mkdir -p releases/console
- name: Make <sha>.tar.gz
run: tar czf releases/console/${{ github.sha }}.tar.gz --directory=dist .
- name: Write sha256sum to file
run: sha256sum releases/console/${{ github.sha }}.tar.gz | awk '{print $1}' > releases/console/${{ github.sha }}.sha256.txt
- name: Copy files to main.*
run: |
cp releases/console/${{ github.sha }}.tar.gz releases/console/main.tar.gz
cp releases/console/${{ github.sha }}.sha256.txt releases/console/main.sha256.txt

@david-crespo david-crespo Jul 5, 2022

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

99% sure nobody was using this, for reasons indicated by the changes to serve-from-nexus.md — ./tools/install_prerequisites.sh in Omicron handles the whole thing for you and it points to a commit.

- name: Upload files to GCP bucket
id: upload-files
uses: google-github-actions/upload-cloud-storage@v0.9.0
Expand Down
16 changes: 6 additions & 10 deletions docs/serve-from-nexus.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,13 @@
# Serving the Console from Nexus

## Wait! You probably don't need to build anything
## Wait! You probably don't need to do anything

Assets from commits on `main` are available at `dl.oxide.computer/releases/console/<sha>.tar.gz`. The latest `main` is probably what you want and can always be found at https://dl.oxide.computer/releases/console/main.tar.gz in addition to the path with the SHA.
Assets from commits on `main` are available at `dl.oxide.computer/releases/console/<sha>.tar.gz`. A console version is pinned in Omicron in the file `tools/console_version`, and the prereqs script `./tools/install_prerequisites.sh` will download the tarball and extract it in the right place.

If you want to use a version of the console that's already merged into `main`, just download the tarball and extract the files into the directory configured as `console.static_dir` in the Nexus config (the default in the example config `nexus/static`).
If you want to use a different commit than the one that's pinned, just change the commmit hash and SHA256 in that file (get the SHA256 at `https://dl.oxide.computer/releases/console/<commit>.sha256.txt`) and re-run the script.

Following the rest of the instructions is only necessary if you want to build the assets yourself, for example if you're making a change to the console and want to test it locally against Nexus.

### Choosing a Console version to download

Most of the time you will want the latest commit on `main`. Look at [`OMICRON_VERSION`](/OMICRON_VERSION) to see what Omicron SHA that version of the console expects. Often it will work with a newer version of the API, but don't be surprised if it doesn't.

## Dependencies

- Node.js (tested on 14+, 16+ recommended)
Expand Down Expand Up @@ -44,7 +40,7 @@ The only difference between this build and the one for local dev is that the lat

The build output lands in the `dist` directory. Now all you need to do is make `console.static_dir` in the Nexus config point to a directory containing these files.

If you're using the example Nexus config, `static_dir` is set there to `nexus/static` (treated as relative to CWD), so that's a reasonable default location for the files. Another option is to point Nexus directly at `dist` so you don't even have to copy them. Nexus accepts both absolute and relative paths.
If you're using the example Nexus config, `static_dir` is set there to `out/console-assets` (treated as relative to CWD), so that's a reasonable default location for the files. Another option is to point Nexus directly at `dist` so you don't even have to copy them. Nexus accepts both absolute and relative paths.

Whatever the directory is, the files need to be at top level, just like they are in `dist`:

Expand All @@ -67,13 +63,13 @@ If I have `console` and `omicron` sitting next to each other in the same directo

```toml
[console]
static_dir = "nexus/static"
static_dir = "out/console-assets"
```

I would run `yarn build-for-nexus` in `console` and then use the following command to copy the files over:

```bash
cp -R dist/ ../omicron/nexus/static
cp -R dist/ ../omicron/out/console-assets
```

The `/` after `dist` is there on purpose — if the target directory already exists, if I leave off the `/` it will copy `dist` into the target with its contents inside rather than the copying only the contents.