Browse Source

WIP docs for docker development

xmkb
Idan Gazit 4 years ago
parent
commit
15614a946f
No known key found for this signature in database
GPG Key ID: FA1E9B15C71BD7FC
  1. 20
      docs/docs/dev-setup.md

20
docs/docs/dev-setup.md

@ -16,6 +16,7 @@ values={[ @@ -16,6 +16,7 @@ values={[
{label: 'macOS', value: 'mac'},
{label: 'Raspberry OS', value: 'raspberryos'},
{label: 'Fedora', value: 'fedora'},
{label: 'VS Code & Docker', value: 'docker'},
]
}>{props.children}</Tabs>);
@ -178,6 +179,20 @@ Homebrew is required to install the system dependencies. If you haven't done so, @@ -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
```
</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>
</OsTabs>
@ -323,6 +338,11 @@ Please be sure to read the [additional setup instructions](https://docs.zephyrpr @@ -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>
</OsTabs>

Loading…
Cancel
Save