今まで何度かOpenStreetMapのタイルサーバーを作っているのですが、時間をかけて同じ作業を何回もしてきました。色々忘れちゃうし、データベースへの展開にも時間がかかるし、一日仕事的な感じですよね。
ということで、今回は「なるべく時間をかけずに」「簡単に」自分の地図サーバを作れることを目標に、Dockerコンテナを作成しましたので、皆さんに共有したいと思います。
あと、各地域の地図を使いたい場合は、地図データを外部のPostgreSQLに入れたほうが良いので、Azure Database for PostgreSQLも使いつつ、より大きな地図データを使う方法も紹介したいと思います。
1. Dockerコンテナ単体で動かすOpenStreetMapのタイルサーバー
まずは、Dockerコンテナ単体で動かすOpenStreetMapのタイルサーバーです。このタイルサーバーは、各地域の形と南極大陸のデータで作成しています。
1.2. 構築と起動方法
Dockerを使ってビルドします。Dockerのインストール方法はこちらをご参照ください。
git clone https://github.com/KentaroAOKI/openstreetmap-docker.git
cd openstreetmap-docker
docker build -t openstreetmaptile .
これだけで終わりです。ビルドにはそこそこ時間がかかるのでビルド済みイメージを使いたい人は以下のコマンドを実行してください。
docker pull kekekekenta/openstreetmaptile
docker rename kekekekenta/openstreetmaptile openstreetmaptile
以下のコマンドで起動してみます。（起動時はRenderdのデータベース設定の初期化処理が動きますので、Webサービスが立ち上がるまで少し待ちます）
docker run -d -p 8080:80 openstreetmaptile
ローカルの環境で動かした場合は、以下のURLにアクセスしてみてください。日本地域のデータは入っていないので形だけですが、動くことを確認できたと思います。（Azureなどのクラウドで起動した場合は、ホスト名の変更とポートのセキュリティ設定の確認が必要です）
私は、Winsows 10 (WSL2 Backend) で動かしましたが、以下のような感じで表示されたと思います。（Azureなどのクラウドで起動した場合は、ホスト名の確認と、ポートのセキュリティ設定を確認してください）
2. Dockerコンテナと外部のPostgreSQLを使用して、各地域のOpenStreetMapデータを使う
Dockerコンテナ内に各地域のOpenStreetMapデータを入れるのは現実的じゃないので、外部のPostgreSQLを使う方法も紹介します。
2.1. PostgreSQLを構築
まずは、PostgreSQLを作ります。ここは皆さんがお持ちの環境もあると思いますので、不要な方は読み飛ばしてください。今回は、簡単に作ることを目標にしていますので、Azure Database for PostgreSQL を使いたいと思います。
まずは、Azureポータルから新規のAzure Database for PostgreSQLを選択します。
Azure Database for PostgreSQL は特徴のある4つの構成から選ぶことができます。今回は「単一サーバー」を選択していますが、プレビューでも問題ない方は、フレキシブルサーバを使ったほうが良いと思います。
バージョンは12でもかまいませんが今回は10を選択します。ストレージサイズによりIOPSの上限が変わります。できるだけ速く処理させたい場合は大きなサイズを選んでください。
最後に、Dockerコンテナからのアクセスを許可するように、接続のセキュリティ設定も忘れないようにしてください。
2.2. PostgreSQLのデータベースを初期化する
PostgreSQLの準備が整ったらOpenStreetMapのタイルサーバー向けにデーターベースを初期化します。
Dockerコンテナでは、以下の環境変数を用意しています。PostgreSQLの接続情報を環境変数に設定することにより外部のPostgreSQLを使うことができます。
- PSQL_HOST : PostgreSQLのホスト名を設定します。 (デフォルト設定は "localhost" です)
- PSQL_PORT : PostgreSQLのポート番号を設定します。(デフォルト設定は "5432" です)
- PSQL_USERNAME : PostgreSQLの管理者を設定します。(デフォルト設定は "postgres" です)
- PSQL_PASSWORD : PostgreSQLの管理者パスワードを設定します。(デフォルト設定は "postgrespassword" です)
- PSQL_DBNAME : 作成するデータベース名を設定します。 (デフォルト設定は "gis" です)
データベースの作成は以下のようにDockerコンテナを実行します。
docker run -ti -e PSQL_HOST=xxxx.postgres.database.azure.com -e PSQL_USERNAME=xxx@xxx -e PSQL_PASSWORD=xxxx openstreetmaptile scripts/01_initialize_database.sh
次に、地図データをデーターベースに書き込みます。（ここでは南極大陸のデータを書き込みます）
docker run -ti -e PSQL_HOST=xxxx.postgres.database.azure.com -e PSQL_USERNAME=xxx@xxx -e PSQL_PASSWORD=xxxx openstreetmaptile scripts/02_write_osm.sh
最後に、各地域の形などExternalのデータを書き込みます。
docker run -ti -e PSQL_HOST=xxxx.postgres.database.azure.com -e PSQL_USERNAME=xxx@xxx -e PSQL_PASSWORD=xxxx openstreetmaptile scripts/03_write_external.sh
2.3. 外部のPostgreSQLに地図データを追加する
地図を追加する場合は、Geofabrik GmbH の OpenStreetMap Data Extractsから取得します。
例えば、日本の地図の場合は以下のように"asia/japan-latest.osm.pbf"をコマンドに渡します。
docker run -ti -e PSQL_HOST=xxxx.postgres.database.azure.com -e PSQL_USERNAME=xxx@xxx -e PSQL_PASSWORD=xxxx openstreetmaptile scripts/append_osm.sh asia/japan-latest.osm.pbf
2.4. 外部のPostgreSQLを使って動かす
外部のPostgreSQLを使用してOpenStreetMapのタイルサーバーを動かす時も、環境変数にPostgreSQLの接続情報を指定してください。
docker run -d -p 8080:80 -e PSQL_HOST=xxxx.postgres.database.azure.com -e PSQL_USERNAME=xxx@xxx -e PSQL_PASSWORD=xxxx openstreetmaptile
日本の地図が入りましたね。
3. 作成されたタイル画像を再利用する
Webページに表示される地図の画像は、Dockerコンテナ内でキャッシュされています。そのためコンテナを起動しなおすと、もう一度地図の画像を作り直すため表示に時間がかかってしまいます。そのため、以下のようにストレージをマウントして起動してもいいかもしれません。
docker run -d -p 80:80 -e PSQL_HOST=xxxx.postgres.database.azure.com -v /home/user/mod_tile:/var/lib/mod_tile openstreetmaptile
さらに、マウントした先のファイルシステムをfuseでAzuer Storage Blobにマウントすると更に再利用が進みますね。
blobfuse を使用して Blob Storage をファイル システムとしてマウントする方法
4. さいごに
いままで何度も休日を潰していましたが、これからは更に進めた実験に時間が使えそうです。
ではー。