README.md

    Zephyr Docker Images

    This repository contains the Dockerfiles for the following images:

    • CI Image (ci): contains only the minimal set of software needed for CI operation.
    • Developer Image (zephyr-build): includes additional tools that can be useful for Zephyr development.

    Developer Docker Image

    Overview

    The Developer docker image includes all tools included in the CI image as well as the additional tools that can be useful for Zephyr development, such as the VNC server for testing display sample applications.

    These images include the Zephyr SDK, which supports building most Zephyr targets.

    Installation

    Using Pre-built Developer Docker Image

    The pre-built developer docker image is available on both GitHub Container Registry (ghcr.io) and DockerHub (docker.io).

    GitHub Container Registry (ghcr.io)

    docker run -ti -v $HOME/Work/zephyrproject:/workdir \
               ghcr.io/zephyrproject-rtos/zephyr-build:latest

    DockerHub (docker.io)

    docker run -ti -v $HOME/Work/zephyrproject:/workdir \
               docker.io/zephyrprojectrtos/zephyr-build:latest

    Building Developer Docker Image

    The developer docker image can be built using the following command:

    docker build -f Dockerfile.user --build-arg UID=$(id -u) --build-arg GID=$(id -g) -t zephyr-build:v<tag> .

    It can be used for building Zephyr samples and tests by mounting the Zephyr workspace into it:

    docker run -ti -v <path to zephyr workspace>:/workdir zephyr-build:v<tag>

    Usage

    Building a sample application

    Follow the steps below to build and run a sample application:

    west build -b qemu_x86 samples/hello_world
    west build -t run

    Building display sample applications

    It is possible to build and run the native POSIX sample applications that produce display outputs by connecting to the Docker instance using a VNC client.

    In order to allow the VNC client to connect to the Docker instance, the port 5900 needs to be forwarded to the host:

    docker run -ti -p 5900:5900 -v <path to zephyr workspace>:/workdir zephyr-build:v<tag>

    Follow the steps below to build a display sample application for the native POSIX board:

    west build -b native_posix samples/display/cfb
    west build -t run

    The application display output can be observed by connecting a VNC client to localhost at the port 5900. The default VNC password is zephyr.

    On a Ubuntu host, this can be done by running the following command:

    vncviewer localhost:5900

    项目简介

    Docker image suitable for development and CI

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/zephyrproject-rtos/docker-image

    发行版本 25

    v0.23.3

    全部发行版

    贡献者 22

    全部贡献者

    开发语言

    • Dockerfile 96.6 %
    • Shell 3.4 %