Skip to content

Commit 5750a8a

Browse files
committed
Added building and deploying your first container page
1 parent 68766f7 commit 5750a8a

3 files changed

Lines changed: 78 additions & 8 deletions

File tree

docs/quickstart/first-app/dev-environment/index.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Setting Up Your Development Environment
33
layout: default
4-
parent: Your First App
4+
parent: Your First Container
55
nav_order: 0
66
---
77

@@ -60,7 +60,7 @@ The toolchain container can also be launched and used interactively as follows:
6060

6161
2. **Run the following command**
6262
```sh
63-
cd samples
63+
cd getting-started
6464
docker run --rm -it -v $(pwd):/home/ocre ghcr.io/atym-io/atym-c-toolchain:latest
6565
```
6666

@@ -72,4 +72,10 @@ At the moment, there is not a docker image that contains the Ocre toolchain. Whi
7272
## Troubleshooting
7373
This section covers common issues you might encounter when setting up your development environment, along with their solutions.
7474

75-
- If you encounter errors opening the dev container, you likely need to authenticate with the GitHub Container Registry. Follow the authentication steps in the [GitHub documentation](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-with-a-personal-access-token-classic).
75+
- If you encounter errors opening the dev container, you likely need to authenticate with the GitHub Container Registry. Follow the authentication steps in the [GitHub documentation](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-with-a-personal-access-token-classic).
76+
77+
---
78+
79+
## Next Steps
80+
81+
Once you're set up your development environment, head over to the [Building And Deploying Your First Container](../first-container) page to learn how to build and deploy your first container using Ocre.
Lines changed: 67 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,70 @@
11
---
2-
title: Creating Your First App
2+
title: Building And Deploying Your First Container
33
layout: default
4-
parent: Your First App
4+
parent: Your First Container
55
nav_order: 1
6-
---
6+
7+
nav_exclude: false
8+
search_exclude: true
9+
---
10+
11+
# Building and Deploying Your First App
12+
13+
Now that you have set up your development environment, you're ready to build and deploy your first container-based application with Ocre. This guide will walk you through the process of building a sample application from our getting-started repository.
14+
15+
---
16+
17+
## Prerequisites
18+
19+
Before proceeding, ensure you have:
20+
- Completed the [Setting Up Your Development Environment](../dev-environment) guide
21+
- Cloned the [`getting-started`](https://github.com/project-ocre/getting-started) repository
22+
23+
---
24+
25+
## Building Your First Container
26+
27+
Let's build your first Ocre container using one of our sample applications.
28+
29+
1. **Navigate to the Samples Directory**
30+
```
31+
cd getting-started/samples
32+
```
33+
2. **Choose a Sample Application:** Browse through the available samples and choose one that interests you. Each sample demonstrates different capabilities of the Ocre platform.
34+
35+
3. **Create and Enter Build Directory:** Once you have jumped into the sample of your choosing, lets create the build directory.
36+
```
37+
mkdir build && cd build
38+
```
39+
40+
4. **Configure the Build**
41+
```
42+
cmake -DWASI_SDK_DIR=/opt/wasi-sdk \
43+
-DCMAKE_TOOLCHAIN_FILE=/opt/wamr-sdk/app-sdk/wamr_toolchain.cmake ..
44+
```
45+
46+
5. **Build the Container**
47+
```
48+
make
49+
```
50+
51+
After successful compilation, you'll find a `sample.nbx` file in your build directory (where "sample" matches your chosen sample name). This is your containerized application, ready for deployment.
52+
53+
{: .important}
54+
If the build fails, ensure you're running these commands within the dev container or interactive Docker environment, not on your host system.
55+
56+
57+
## Deploying Your First Container
58+
59+
Now that you've built your container, let's get it running on your device.
60+
61+
{: .important}
62+
Steps to be updated soon
63+
64+
---
65+
66+
## What's Next?
67+
Now that you've successfully built your first container, you can:
68+
69+
- Explore other [samples](../../../samples) to learn more about Ocre's capabilities
70+
- Learn how to create your own container from scratch using the [Ocre Container APIs](../../../reference/container-api)

docs/quickstart/first-app/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Your First App
2+
title: Your First Container
33
layout: default
44
parent: Quickstart
55
nav_order: 3
@@ -18,4 +18,4 @@ Begin by following our [Setting Up Your Development Environment](./dev-environme
1818
- Using Visual Studio Code with Dev Containers for an integrated IDE experience
1919
- Using Docker interactively for a command-line workflow
2020

21-
Once your environment is ready, proceed to [Creating Your First App](./first-container) to create your first Ocre application.
21+
Once your environment is ready, proceed to [Building And Deploying Your First Container](./first-container) to continue with your first Ocre application.

0 commit comments

Comments
 (0)