トをルーティングまたは書き換えたりするほか、使用を制限し、有効なリクエストとし
て受け入れられるものと受け入れられ ないものを定義することができます。APIゲート
ウェイは 、提 供 するユースケ ース に密 接 に 関 連し 、無 限に 定 義 できるため 、APIゲート
ウェイに対する唯一のソリューションというものはありません。
APIゲートウェイは、運用チームとアプリケーションチームの間に究極のコラボレー
シ ョ ン ス ペ ース を 提 供 し 、真 の DevOps組 織 を 形 成 で き る よ う に し ま す 。ア プ リ ケ ー
ション開発では、特定のリクエストの有効 性パラメータを定義します。こうしたリクエス
ト の 配 信 は 、通 常 、ITと見なされるもの（ネットワーク、インフラストラクチャ、セキュリ
ティ、およびミドルウェアのチーム）によって管理されます。APIゲートウェイは、これら
2つ のレ イヤ ー 間 の イ ン タ ーフェ ース として 機 能 し ま す。APIゲ ー ト ウ ェ イ の 構 築 に は 、す
べての関係者からのインプットが必要です。その構成は、ある種のソース管理の範囲の
中で行われる必 要があります。現 代の多くのソース管 理リポジトリには、コード所有者の
コンセプトがあります。このコンセプトにより、特定のファイルに対して特定のユーザー
の承認を要求できます。この方法で、チームは共同作業を行いながら、特定の部門に固
有の 変 更を検 証することができます。
APIゲートウェイの使用にあたり留意すべき点は、URIパ ス で す 。こ の 構 成 例 で は 、URI
パス全体がアップストリームサーバーに渡されます。つまり、service_1例は/api/
service_1/*パスにハンドラーが必要だということです。この方法でパスベースのルー
ティングを実行するには、アプリケーションに別のアプリケーションと競合するルート
がないことが ベストです。
競合するルートが適用される場合にできることがいくつかあります。コードを編集して競
合を解決するか、一方または両方のアプリケーションにURIプレフィックス構 成を 追 加し
て、一方を別のコンテキストに移動します。編集できない既製のソフトウェアの場合は、リ
クエ ストURIアップストリームを書き換えることができます。ただし、アプリケーションが
本文にリンクを記載して返す場合は、クライアントに提供する前に、正規表現（regex）を
使 用してリクエストの本 文を書き換える 必 要 があります。これ は避けるべきやり方 です。
関連項目
APIゲートウェイとして NGINX Plusを デ プ ロ イ（ 電 子 書 籍 ）
11.2 NGINX PlusでのDNS SRVレコードの使 用
問題
NGINX Plusを 使 用して、アップ ストリームサ ーバー のソースとして 既 存 の DNS SRVレ
コードの実 装を 使 用したいと考えています。
解決法
アップストリームサーバーで http値を使用してサービスディレクティブを指定し、SRVレ
コードをロードバランシングプールとして利用するようにNGINXに指 示します。
120 | 第11章：コン テ ナ /マイクロサ ービス
http {
resolver 10.0.0.2 valid=30s;
upstream backend {
zone backends 64k;
server api.example.internal service=http resolve;
}
}
この機能はNGINX Plusで の み 利 用 で き ま す 。こ の 構 成 は 、10.0.0.2のDNSサーバーか
らDNSを 解 決 し 、単 一 の serverディレ クティブ を 使 用して アップ ストリームサ ーバー
プールを設定するようにNGINX Plusに指 示します。resolveパラメータで指 定されたこ
のserverディレクティブ は、DNSレコード TTL、ま た は resolverディレクティブの 有 効な
オーバーライドパラメータに基づいてドメイン名を定期的に再解決するように指示さ
れます。service=http パ ラ メ ー タ と 値 は 、こ れ が IPとポートのリストを含む SRVレコード
であり、server ディレクティブで構成されているかのようにそれらを負荷分 散すること
をNGINXに 通 知します。
解説
動 的インフラストラクチャは 、クラウドベースの インフラストラクチャの需 要と採 用に
ともない、ますます人気が高まっています。Auto Scaling環境は水平方向にスケーリン
グし、負荷の需要に合わせてプール内のサーバーの数を増減します。水平方向にスケー
リ ン グ す る に は 、プ ー ル に リ ソ ー ス を 追 加 し た り 、プ ー ル か ら リ ソ ー ス を 削 除 し た り で
きるロードバラン サーが 必 要です。SRVレ コ ー ド を 使 用 す る と 、サ ー バ ー の リ ス ト を DNS
に保持する責任を回避できます。このタイプの構成は、コンテナ化された環境にとって
非常に魅力的です。コンテナが可変のポート番号で、場合によっては同じIPアドレスで
ア プリケーション を実 行してい る可 能 性 があ るた めで す。UDP DNSレコードのペイロー
ドは約512バイトに制限されている点にご注意ください。
11.3 公式NGINXイメー ジ の 使 用
問題
Docker HubのNGINXイメー ジ を 使 用して す ば やく起 動して 実 行 する 必 要 が あります。
解決法
Docker Hub.からNGINXイメー ジ を 使 用します。この イメー ジに は デ フォルトの 構 成 が 含
まれます。構成を変更するには、ローカル構成ディレクトリをマウントするか、Dockerfile
を作成して構成にイメージビルドをADDする必要があります。ここでは、NGINXのデフォ
ルト構成が静的コンテンツを配信するボリュームをマウントし、単一のコマンドを使用
してその 機 能 を 示します：
$ docker run --name my-nginx -p 80:80
-v /path/to/content:/usr/share/nginx/html:ro -d nginx
11.3 公式NGINXイメー ジ の 使 用 | 121
dockerコマンドは、ローカルで見つからない場合、Docker Hubからn gin x:l a t e s t イメー
ジ を 取 得 し ま す 。次 に 、コ マ ン ド は こ の NGINXイメー ジ をDockerコン テ ナとして 実 行
し、localhost:80をNGINXコン テナのポート80にマッピングします。また、ローカルデ
ィレ クトリ/path/to/content/ を/usr/share/nginx/html/ にコン テ ナ ボリュームとして 読 み
取 り 専 用 と し て マ ウ ン ト し ま す 。デ フ ォ ル ト の NGINX構成は、このディレクトリを静的
コンテンツとして提供します。ローカルマシンからコンテナへのマッピングを指定する
場合、ローカルマシンのポートまたはディレクトリが最初になり、コンテナのポートま
たはディレ クトリは 2番目になります。
解説
NGINXは 、公 式 の Dockerイメー ジ をDockerHubから利用できるようにしました。この公
式のDockerイメージを使用することで、お気に入りのアプリケーションデリバリープラッ
トフォ ームで あ る NGINXを 使 用して Dockerをすばやく簡単に起動できます。このセク
シ ョ ン で は 、た っ た 1つのコマンドでNGINXをコンテナで起動して実行することができま
した。この例で使用した公式のNGINX Dockerイメー ジの主 たる 部 分 は 、Debian Jessie
Dockerイ メ ー ジ か ら 構 築 さ れ て い ま す 。た だ し 、Alpine Linuxに基づいて公式イメージ
を選 択できます。Dockerfileとこれらの公式イメージのソースは、GitHubで入手できま
す 。独 自 の Dockerfileを構築し、FROMコマンドで公式イメージを指定することで、公式
イメー ジ を 拡 張で きます。NGINX構 成 ディレクトリを Dockerボリュームとしてマ ウント
して 、公 式 イ メ ー ジ を 変 更 せ ず に NGINX構成をオーバーライドすることもできます。
関連項目
NGINX公式 Docker imageイメージ、NGINX
Docker repo on GitHub
11.4 NGINX Dockerfileの作成
問題
Dockerイメー ジ を 作 成 するため に 、NGINX Dockerfileを 作成したいです。
解決法
気 に 入った ディストリビューション の Dockerイメー ジ FROMから開 始します。RUNコマン
ドを 使 用して NGINXをインストールします。ADDコマンドを 使 用して、NGINX構成フ
ァイルを追加します。EXPOSE コマンドを使用して、指定されたポートを公開するよう
にDockerに指示するか、イメージをコンテナとして実行する際にこれを手動で実行しま
す。イメージがコンテナとしてインスタンス化されたら、CMDを 使 用して NGINXを起動し
ます。NGINXを フ ォ ア グ ラ ン ド で 実 行 す る 必 要 が あ り ま す 。そ の た め に は 、NGINXを-g
"daemon off;"で 始 め る か 、構 成 に daemon off; を 追 加 し ま す 。こ の 例 で は 、後 者 を 使
用 し て 、構 成 フ ァ イ ル の メ イ ン コ ン テ キ ス ト に daemon off; を 追 加 し ま す 。ま た 、ア ク セ
122 | 第11章：コ ン テ ナ /マイクロ サ ービス
スログの場合は/dev/stdout に 、エ ラ ー ロ グ の 場 合 は /dev/stderr にログを記録するよう
にNGINX構成を変 更することもできます。こうすることで、ログがDockerデーモンに
渡り、Dockerで使 用するために選択したログドライバーに基づいて、ログをより簡単
に 利 用 できるようになります：
FROM centos:7
# Install epel repo to get nginx and install nginx
RUN yum -y install epel-release &&
yum -y install nginx
# add local configuration files into the image
ADD /nginx-conf /etc/nginx
EXPOSE 80 443
CMD ["nginx"]
ディレクトリの構成は以下のような見かけです：
.
├──Dockerfile
└──nginx-conf
├──conf.d
│ └──default.conf
├──fastcgi.conf
├──fastcgi_params
├──koi-utf
├──koi-win
├──mime.types
├──nginx.conf
├──scgi_params
├──uwsgi_params
└──win-utf
Dockerfileに1行だけ追加するだけでNGINX構成すべてを追加し、すべての構成に簡
単 に ア ク セ ス で き る よ う に 、こ の Dockerディレ クトリ内 で NGINX構 成 全 体 をホストす
ることを選択しました。
解説
インストールされたパッケージと更新を完全に制御する必要がある場合は、独自の
Dockerfileを作成すると便利です。ベースイメージが信頼でき、本番環境で実行する前
にチームによってテストされていることを確認できるように、イメージの独自のリポジ
トリを保 持するの が 一 般 的です。
11.4 NGINX Dockerfileの作成 | 123
11.5 NGINX Plus Dockerイメー ジ の 構 築
問題
コンテナ化された環境でNGINX Plusを実行するために、NGINX Plus Dockerイメー ジ
を構 築したいです。
解決法
このDockerfileを 使 用して、NGINX Plus Dockerイメー ジ を構 築します。NGINX Plus
リポジトリ証 明 書をダウンロードし、それぞれ nginx-repo.crt とnginx-repo.keyという名
前のDockerfileを使用してディレクトリに保 存する必要があります。これにより、この
Dockerfileは 、使 用 す る NGINX Plusをインストールし、NGINXアクセスログとエラー
ログをDockerログコレクターにリンクする残りの作業を実行します。
FROM debian:stretch-slim
# Download certificate and key from the customer portal
# (https://cs.nginx.com) and copy to the build context
COPY nginx-repo.crt /etc/ssl/nginx/
COPY nginx-repo.key /etc/ssl/nginx/
# Install NGINX Plus
RUN set -x
&& APT_PKG="Acquire::https::plus-pkgs.nginx.com::"
&& REPO_URL="https://plus-pkgs.nginx.com/debian"
&& apt-get update && apt-get upgrade -y
&& apt-get install
--no-install-recommends --no-install-suggests
-y apt-transport-https ca-certificates gnupg1
&&
NGINX_GPGKEY=573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62;
found='';
for server in
ha.pool.sks-keyservers.net
hkp://keyserver.ubuntu.com:80
hkp://p80.pool.sks-keyservers.net:80
pgp.mit.edu
; do
echo "Fetching GPG key $NGINX_GPGKEY from $server";
apt-key adv --keyserver "$server" --keyserver-options
timeout=10 --recv-keys "$NGINX_GPGKEY"
&& found=yes
&& break;
done;
test -z "$found" && echo >&2
"error: failed to fetch GPG key $NGINX_GPGKEY" && exit 1;
124 | 第11章：コ ン テ ナ /マイクロ サ ービス
..................Content has been hidden....................
You can't read the all page of ebook, please click here login for view all page.