ラズパイの環境構築の一環で Docker 周りの環境を用意したので、記録しておきます。

Docker

Docker の公式に用意されているインストールスクリプトで簡単にインストールすることができます。

$ curl -sSL https://get.docker.com/ | sh

インストールが終わったら Docker のコマンドの権限をユーザに与えます。

$ sudo usermod -aG docker <username>

例えば、ユーザ名が pi ならば sudo usermod -aG docker pi となります。

Docker Compose

Docker Compose は Python の pip を使うと簡単にインストールできます。
Python がインストールされていない人はインストールしてください。
また、公式では環境を汚さないために、仮想環境を使用することが推奨されています。

まず、依存ライブラリをインストールします。

$ sudo apt install libffi-dev

次に Docker Compose 本体をインストールしていきます。

$ pip install docker-compose

おわりに

sudo apt install docker docker-compose で全て入る未来は来ないんですかね？

ラズパイにを操作するのに、ディスプレイやキーボード、マウスを用意するのが面倒なので、macOS から画面共有できるようにします。

x11vnc のインストール

x11vnc は VNC プロトコルを利用した画面共有を実現するためのものです。

Raspbian では以下のコマンドでインストールすることができます。

$ sudo apt install x11vnc

x11vnc の設定

画面共有の認証に使うパスワードを以下のコマンドで設定します。

$ x11vnc -storepasswd

パスワード入力すると Write password to /home/<user_name>/.vnc/passwd? [y]/n と確認されます。こちらは次に説明する自動起動設定に使用するので y で解答します。

また、Raspberry Pi にディスプレイを接続している場合は、画面共有時、そのディスプレイと同じ画面、同じ解像度で表示されます。
ディスプレイを接続していない場合は、「Raspberry Pi の設定」のディスプレイの解像度が使用されるため、解像度を変更したい場合はこちらを変更します。（コマンドラインから変更する場合は sudo raspi-config > Display Options から設定します）

自動起動設定

起動時に毎回、手動で立ち上げるのでは、あまり意味がないので、自動起動の設定を行います。

まず、以下の内容の x11vnc.service というファイルを /etc/systemd/system/ に作成します。

[Unit]
Description=X11vnc
After=multi-user.target

[Service]
Type=simple
ExecStart=/usr/bin/x11vnc -forever -auth guess -rfbauth /home/pi/.vnc/passwd

[Install]
WantedBy=multi-user.target

これは systemd という Raspbian で採用されているデーモンの設定ファイルで、それぞれのオプションについてはここでは説明しませんが、x11vnc に限らず、自由に自動起動の設定が行えるので、覚えておくと良いでしょう。

また x11vnc の実行オプションにこだわりのある方は上記の ExecStart の行にオプションを書き加えることで実行オプションを変更することができます。

上記の設定ファイルを保存したら、以下のコマンドで設定ファイルを読み込ませます。

$ sudo systemctl daemon-reload

次に、設定が正しく行えて起動できるかを確認するために以下のコマンドで起動します。

$ sudo systemctl start x11vnc

後述する接続方法で接続ができれば、以下のコマンドで、自動起動を有効にします。

$ sudo systemctl enable x11vnc

画面共有の接続

macOS から確認するには 画面共有.app を使用します。画面共有.app は Spotlight から検索すると出てきます。

アドレスには Raspberry Pi のホスト名か IP アドレスを指定します。

または、Finder からサーバへ接続（ Command + K ）をし、vnc://raspberrypi.local/ に接続することでも画面共有を開始できます。

この際 raspberrypi.local の部分は環境によって IP アドレスやホスト名に適宜変更してください。

おわりに

これでラズパイ用の周辺機器がなくても操作できるようになりました。

ラズパイをセットアップしたので、ファイル共有の設定をしていきたいと思います。

Samba のインストール

Samba は SMB プロトコルを利用したファイル共有を実現するためのものです。

Raspbian では以下のコマンドでインストールすることができます。

$ sudo apt install samba

ホームディレクトリを設定

インストールした Samba の設定ファイルは /etc/samba/smb.conf にあります。これを編集してホームディレクトリにアクセスできるようにします。

お好きなエディタか sudo nano /etc/samba/smb.conf のコマンドで以下のように編集してください。

# の行はコメントなので入力する必要はありません

# [homes] より下を編集
# browsable = no を yes に変更
browsable = yes
# read only = yes を no に変更
read only = no
# create mask = 0700 をコメントアウト / もしくは権限変更
# directory mask = 0700 をコメントアウト / もしくは権限変更

これで設定ファイルを保存すれば、ホームディレクトリにアクセスできます。

Samba ユーザの作成

Samba のユーザを作成するため以下のコマンドでユーザを作成します。

$ sudo smbpasswd -a <user_name>

<user_name> は自分の好きなものにします。例えば pi の場合は sudo smbpasswd -a pi となります。

Samba の再起動

変更した設定を読み込ませるために以下のコマンドで、Samba を再起動します。

$ sudo systemctl restart smbd

これで他のデバイスからホームディレクトリに自由にアクセスできるようになります。

他のデバイスからアクセス。

例えば macOS からは Finder で Command + K でサーバへ接続し、 smb:/raspberrypi.local/ に先ほど作成したユーザで接続すると、ディレクトリが選択できて Home を選ぶと、ホームディレクトリに移動できます。

この際 raspberrypi.local の部分は環境によって IP アドレスやホスト名に適宜変更してください。

おわりに

これでファイルの移動や共有が簡単になりました。

クローゼットに眠っていたラズパイを有効活用すべく、久しぶりにセットアップを行ったので、その記録です。

Raspbian のダウンロード

まずは OS 本体をダウンロードしてきます。

ダウンロードサイト

好きなバージョンを選んでダウンロードします。僕は GUI 環境が欲しかったので Raspbian Buster with desktop を選びました。

SD カードに書き込み

SD カードのアンマウント

書き込みに備えて、SD カードをアンマウント状態にします。

ターミナルから diskutil list コマンドを実行して、SD カードのデバイス番号を取得します。環境にもよりますが /dev/disk0 や /dev/disk1 などは macOS のために使用されるため、/dev/disk2 以降に割り当てられていると思います。

僕の環境では /dev/disk2 であったため、これ以降は /dev/disk2 の表記を使いますが、それぞれの番号に置き換えてコマンドを実行してください。

アンマウントは以下のコマンドで実行できます。

$ diskutil unmountDisk /dev/disk2

OS の書き込み

書き込みは dd コマンドを使用して、dd if=<path_to_os> of=<disk> の様に実行できます。

執筆時点で最新の Raspbian を使用して、カレントディレクトリに解凍してある場合は以下のコマンドで、書き込むことができます。

$ sudo dd if=2020-02-13-raspbian-buster.img of=/dev/rdisk2 bs=1m

ここで、気をつけたいのが、先ほど確認したデバイスは /dev/disk2 であったのに対し、今回の入力では /dev/rdisk2 を使用しています。

/dev/disk2 はバッファリングを使用しアクセスするのに対し、/dev/rdisk2 は直にデバイスへアクセスするため、書き込みを高速化することができます。

またオプションの bs=1m も高速化のために使用しています。

どちらも高速化のために行っているので、 sudo dd if=2020-02-13-raspbian-buster.img of=/dev/disk2 という通常コマンドでも、問題なく書き込むことができます。

時間は記録してませんが 5 – 10 分程度だった気がします。

Raspberry Pi で起動確認

書き込んだ SD カードを Raspberry Pi に戻し、起動させます。ちゃんと起動すれば成功です。

セットアップが始まるので、ガイドに沿って進めていきましょう。

おわりに

前は FreeBSD で使ってたので Raspbian のセットアップは購入時以来だったのですが、ガイドに沿って進めるとめちゃくちゃ簡単に使えるんですね。

もっと苦戦するものかと思ってました。