WIP docs for docker development

This commit is contained in:
Idan Gazit 2020-10-01 00:41:33 -07:00
parent 42d1915ced
commit 15614a946f
No known key found for this signature in database
GPG key ID: FA1E9B15C71BD7FC

View file

@ -16,6 +16,7 @@ values={[
{label: 'macOS', value: 'mac'}, {label: 'macOS', value: 'mac'},
{label: 'Raspberry OS', value: 'raspberryos'}, {label: 'Raspberry OS', value: 'raspberryos'},
{label: 'Fedora', value: 'fedora'}, {label: 'Fedora', value: 'fedora'},
{label: 'VS Code & Docker', value: 'docker'},
] ]
}>{props.children}</Tabs>); }>{props.children}</Tabs>);
@ -178,6 +179,20 @@ Homebrew is required to install the system dependencies. If you haven't done so,
brew install cmake ninja python3 ccache dtc git wget brew install cmake ninja python3 ccache dtc git wget
``` ```
</TabItem>
<TabItem value="docker">
This setup leverages the same [image which is used by the GitHub action](https://github.com/zmkfirmware/zephyr-west-action) for local development. Beyond the benefits of [dev/prod parity](https://12factor.net/dev-prod-parity), this approach is also the easiest to set up. No toolchain or dependencies are necessary when using Docker; the container image you'll be using already has the toolchain installed and set up to use.
1. Install [Docker Desktop](https://www.docker.com/products/docker-desktop) for your operating system.
2. Install [VS Code](https://code.visualstudio.com/)
3. Install the [Remote - Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
:::info
The docker container includes `west` and the compilation toolchain. If you're using docker and VS Code, you can skip right to [Source Code](#source-code).
:::
</TabItem> </TabItem>
</OsTabs> </OsTabs>
@ -323,6 +338,11 @@ Please be sure to read the [additional setup instructions](https://docs.zephyrpr
::: :::
</TabItem>
<TabItem value="docker">
You're already set up: the toolchain is installed and configured inside the docker container.
</TabItem> </TabItem>
</OsTabs> </OsTabs>