Go to Qiita Advent Calendar 2024 Top
LoginSignup
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@fukunagt(福永 崇顕)

GitHubで公開されているEMLinux 3.1にDockerをインストールしてみた

Last updated at Posted at 2024-05-08

はじめに

  • EMLinux 3.1にDockerをインストールし、NGINXのコンテナを動かしてみました。
  • 本記事では、GitHubのリポジトリで公開されているEMLinuxを使用しました。
    • meta-emlinux
      • なお、こちらは製品版ではないので、商用サポートはありません。

構成図

+--------------------------------+
| +----------------------------+ |
| | +------------------------+ | |
| | | +--------------------+ | | |
| | | | +----------------+ | | | |
| | | | | NGINX          | | | | |
| | | | +----------------+ | | | |
| | | | Docker             | | | |
| | | +--------------------+ | | |
| | |  EMLinux 3.1           | | |
| | +------------------------+ | |
| | QEMU                       | |
| +-+--------------------------+ |
|   |                            |
| +-+----+                       |
| | tap0 |                       |
| +-+----+                       |
|   |                            |
| +-+----------------------+     |
| | virbr0 (192.168.122.1) |     |
| +------------------------+     |
|                                |
| Ubuntu Server                  |
+--------------------------------+

各ソフトウェアのバージョン

Ubuntu Server

$ cat /etc/lsb-release 
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=20.04
DISTRIB_CODENAME=focal
DISTRIB_DESCRIPTION="Ubuntu 20.04.6 LTS"

QEMU

$ qemu-system-aarch64 --version 
QEMU emulator version 4.2.1 (Debian 1:4.2-3ubuntu6.28)
Copyright (c) 2003-2019 Fabrice Bellard and the QEMU Project developers

EMLinuxのビルドに必要なパッケージのインストール

  1. 以下の記事を参考に、EMLinuxのビルドに必要なパッケージをインストールしてください。

meta-emlinuxリポジトリのクローン

  1. meta-emlinuxのリポジトリのクローン先のディレクトリを作成してください。 
    mkdir -p /home/emlinux/github/emlinux/bookworm/docker/repos
  2. 以下のディレクトリに移動してください。 
    cd /home/emlinux/github/emlinux/bookworm/docker
  3. 以下の記事を参考に、meta-emlinuxのリポジトリをクローンしてください。

カスタムレイヤーの作成

  1. 以下のディレクトリに移動してください。 
    cd /home/emlinux/github/emlinux/bookworm/docker/repos
  2. 以下のディレクトリを作成してください。 
    meta-custom/
├── conf
│   └── layer.conf
├── COPYING.MIT
├── README
└── recipes-docker
    ├── configure-docker
    │   ├── configure-docker.bb
    │   └── files
    │       ├── http-proxy.conf
    │       └── postinst
    └── images
        └── emlinux-image-base.bbappend
    • layer.conf 
      #
# layer profile
#

BBPATH .= ":${LAYERDIR}"

BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
        ${LAYERDIR}/recipes-*/*/*.bbappend"

BBFILE_COLLECTIONS += "custom"
BBFILE_PATTERN_custom = "^${LAYERDIR}/"
BBFILE_PRIORITY_custom = "30"

LAYERSERIES_COMPAT_custom = "next"

LAYERDIR_custom = "${LAYERDIR}"
    • COPYING.MIT
    • README 
      # This directory contains the files to install Docker on EMLinux.
    • configure-docker.bb 
      FILESEXTRAPATHS:prepend := "${FILE_DIRNAME}/files:"

DESCRIPTION = "Setup script for Docker"

DEBIAN_DEPENDS = "docker.io"

inherit dpkg-raw

SRC_URI = " \
    file://postinst \
    file://http-proxy.conf \
"

do_install() {
    install -v -d ${D}/etc/systemd/system/docker.service.d
    install -v -m 644 ${WORKDIR}/http-proxy.conf ${D}/etc/systemd/system/docker.service.d/
}
    • http-proxy.conf 
      [Service]
Environment="HTTP_PROXY=<proxyサーバのIPアドレス>:<ポート番号>"
Environment="HTTPS_PROXY=<proxyサーバのIPアドレス>:<ポート番号>"
    • postinst 
      #!/bin/sh
systemctl enable docker
update-alternatives --set iptables /usr/sbin/iptables-legacy
    • emlinux-image-base.bbappend 
      # Add packages for Docker
IMAGE_PREINSTALL:append = " \
    ca-certificates \
    connman \
    docker.io \
"

EMLinuxのビルド

  1. meta-emlinux/dockerに移動し、run.shを実行してください。 
    cd /home/emlinux/github/emlinux/bookworm/docker/repos/meta-emlinux/docker

    ./run.sh
  2. コンテナにログイン後、環境変数を設定してください。 
    source repos/meta-emlinux/scripts/setup-emlinux build
  3. viコマンドで、conf/bblayers.confの末尾に以下を追記してください。 
    BBLAYERS += "${TOPDIR}/../repos/meta-custom"
  4. meta-customレイヤーが追加されていることを確認してください。 
    $ bitbake-layers show-layers
NOTE: Starting bitbake server...
layer                 path                                      priority
==========================================================================
meta                  /home/build/work/build/../repos/isar/meta  5
meta-emlinux          /home/build/work/build/../repos/meta-emlinux  12
isar-cip-core         /home/build/work/build/../repos/isar-cip-core  6
meta-custom           /home/build/work/build/../repos/meta-custom  30
  5. viでconf/local.confを開き、末尾に以下を追記してください。 
    # ARM64
MACHINE = "qemu-arm64"

# Setup for Docker
IMAGE_INSTALL:append = " configure-docker"

# Extra space for rootfs in MB
ROOTFS_EXTRA = "10240"
  6. EMLinuxをビルドしてください。 
    bitbake emlinux-image-base
  7. ビルド完了後、exitコマンドでコンテナからログアウトしてください。 
    build@82fa043f8378:~/work$ exit 
exit

tap0の作成

  1. 以降の作業はsudo権限があるユーザで行ってください。
  2. 仮想ブリッジvirbrを有効化するため、libvirt-daemon-systemをインストールしてください。 
    sudo apt install libvirt-daemon-system
  3. 以下のコマンドを実行し、tap0を作成してください。 
    sudo ip tuntap add tap0 mode tap

    sudo ip link set tap0 promisc on

    sudo ip link set dev tap0 master virbr0

    sudo ip link set dev tap0 up

EMLinuxの起動

  1. 以下のディレクトリに移動してください。 
    cd /home/emlinux/github/emlinux/bookworm/docker/build
  2. run.shファイルを作成してください。 
    touch run.sh

    chmod +x run.sh
  3. vimでrun.shファイルを以下のように編集してください。 
    qemu-system-aarch64 \
-net nic \
-net tap,ifname=tap0,script=no \
-drive id=disk0,file=./tmp/deploy/images/qemu-arm64/emlinux-image-base-emlinux-bookworm-qemu-arm64.ext4,if=none,format=raw \
-device virtio-blk-device,drive=disk0 -show-cursor -device VGA,edid=on \
-device qemu-xhci \
-device usb-tablet \
-device usb-kbd \
-object rng-random,filename=/dev/urandom,id=rng0 \
-device virtio-rng-pci,rng=rng0 \
-nographic \
-machine virt \
-cpu cortex-a57 \
-m 2G \
-serial mon:stdio \
-serial null \
-kernel ./tmp/deploy/images/qemu-arm64/emlinux-image-base-emlinux-bookworm-qemu-arm64-vmlinux \
-initrd ./tmp/deploy/images/qemu-arm64/emlinux-image-base-emlinux-bookworm-qemu-arm64-initrd.img \
-append 'root=/dev/vda rw highres=off console=ttyS0 mem=2G ip=dhcp console=ttyAMA0'
  4. suコマンドで、sudo権限があるユーザに切り替えてください。
  5. run.shを実行してください。 
    sudo ./run.sh
    • パスワードを問われる場合には、sudo権限があるユーザのパスワードを入力してください。
  6. rootユーザでログインしてください。既定のパスワードはrootです。 
    EMLinux3 login: root
Password:
  7. IPアドレスが割り振られていることを確認してください。 
    root@EMLinux3:~# ip a
(snip)
2: enp0s1: <BROADCAST,MULTICAST,DYNAMIC,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
 link/ether 52:54:00:12:34:56 brd ff:ff:ff:ff:ff:ff
 inet 192.168.122.77/24 metric 1024 brd 192.168.122.255 scope global dynamic enp0s1
    valid_lft 3523sec preferred_lft 3523sec
(snip)
  8. コンテナイメージの検索が行えるか確認してください。 
    root@EMLinux3:~# docker search nginx 
NAME                                              DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
nginx                                             Official build of Nginx.                        19768     [OK]       
(snip)
  9. 以下のコマンドを実行し、NGINXのコンテナを起動してください。 
    docker run -it -d --name nginx-test -p 80:80 nginx:latest
  10. コンテナホストからcurlコマンドで、NGINXにアクセスできることを確認してください。 
    $ curl 192.168.122.77 --noproxy 192.168.122.77
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
(snip)

さいごに

EMLinux 3.1のレシピをカスタマイズし、Dockerをインストールしてみました。また、docker runでNGINXのコンテナイメージを使い、Webサーバを起動してみました。

ただ、組み込み機器では、わざわざ組み込み機器にログインし、docker runなどを実行することはないため、Webサーバ経由などで外部から任意のコマンドを実行できるような仕組みが必要と考えていますが、それはまた別の記事で。

補足

Dockerを動作させるために必要なパッケージについて

  • Dockerはiptablesに依存しています。また、iptablesを利用するために、update-alternatives --set iptables /usr/sbin/iptables-legacyを実行しています。
  • docker pullなど外部との通信を行うために、ca-certificatesをインストールしています。

ROOTFS_EXTRAについて

カスタムレイヤーの作成について

上述の手順の場合、ディレクトリやファイルを作成していただく必要があります。

同手順をGitHubにも掲載しております。GitHubの手順はlayerをダウンロードする手順となっています。上述の手順で「ディレクトリやファイルの作成が面倒だなぁ…」と思われた方は、GitHubに記載の手順をご利用ください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?