fix: improve Harmonia quick start cleanup (#21221)

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

Added additional cleanup steps and other minor improvements to the
Harmonia quick start guide.

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
This commit is contained in:
David Dooling 2024-10-24 00:05:18 -10:00 committed by GitHub
parent c82547b0e2
commit fb848e9c8d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 40 additions and 23 deletions

View File

@ -87,7 +87,7 @@ You should see the following:
1. Run an Nginx container in the cloud engine:
```console
$ docker run -d -p 8080:80 nginx
$ docker run -d --name cloudnginx -p 8080:80 nginx
```
This maps the container's port `80` to the host's port `8080`. If port `8080` is already in use on your host, you can specify a different port.
2. View the Nginx welcome page. Navigate to [`http://localhost:8080/`](http://localhost:8080/).
@ -97,6 +97,10 @@ You should see the following:
```console
$ docker ps
```
4. Shut down the container:
```console
$ docker kill cloudnginx
```
Running a container with a cloud engine is just as straightforward as running it locally.
@ -179,9 +183,10 @@ Project Harmonia takes advantage of [Synchronized file shares](/manuals/desktop/
1. Make sure your Docker context is set to `cloudengine`.
2. In the Docker Desktop Dashboard, navigate to the **Containers** view.
3. Select the **lock** icon in the **Ports** column of your running container next to `3000:3000`.
3. If necessary, expand the application listing to show all of its containers.
4. Select the **lock** icon in the **Ports** column of your running container next to `3000:3000`.
This creates a publicly accessible URL that you can share with teammates.
4. Select the **copy** icon, to copy this URL.
5. Select the **copy** icon, to copy this URL.
To view all shared ports for your Docker context, select the **Shared ports** icon in the bottom-right corner of the Docker Desktop Dashboard.
@ -208,6 +213,12 @@ $ docker harmonia engine share list
{{< tabs group="method" >}}
{{< tab name="Docker Desktop">}}
To stop the running project:
```console
$ docker compose down
```
To remove a file sync session:
1. Navigate to your cloud engine in the **Project Harmonia** view.
2. Select the **Actions** menu and then **Manage file syncs**.
@ -219,6 +230,12 @@ To remove a cloud engine, navigate to the **Project Harmonia** view and then sel
{{< /tab >}}
{{< tab name="CLI">}}
To stop the running project:
```console
$ docker compose down
```
To remove the file sync session, run:
```console