rebuild

Author: shibukawa

docs/_sources/deploy.rst.txt

@@ -354,7 +354,7 @@ Dockerfileができたらイメージをビルドして実行してみましょ
 distrolessベースのDockerイメージの作成
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-distrolessはシェルが入っていおらず、外部からログインされることもなく安全というGoogle製のDockerイメージです。標準Linuxに入っているようなツールも含めて、最小限にカットされています。Node.js、Java、Python、.netなど言語のランタイムだけが入ったバージョン、llvmベースのコンパイラで作成したコードを動かすだけのバージョン、何もないバージョンなど、いくつかのバリエーションが用意されています。今回はNode.jsを使います。
+distrolessはシェルが入っておらず、外部からログインされることもなく安全というGoogle製のDockerイメージです。標準Linuxに入っているようなツールも含めて、最小限にカットされています。Node.js、Java、Python、.netなど言語のランタイムだけが入ったバージョン、llvmベースのコンパイラで作成したコードを動かすだけのバージョン、何もないバージョンなど、いくつかのバリエーションが用意されています。今回はNode.jsを使います。
 
 現在、8種類タグが定義されています。latestはLTSが終わるまでは10のままです。\ ``debug``\ がついているものはデバッグ用のシェルが内蔵されています。
 
@@ -367,7 +367,7 @@ distrolessはシェルが入っていおらず、外部からログインされ
 * ``gcr.io/distroless/nodejs:12-debug``
 * ``gcr.io/distroless/nodejs:14-debug``
 
-一般的なの\ ``Dockerfile``\ は、\ ``ENTRYPOINT``\ がシェル、\ ``CMD``\ がそのシェルから呼び出されるプログラムです。distrolessはシェルがなく、\ ``ENTRYPOINT``\ にNode.jsが設定されている、\ ``CMD``\ にはJavaScriptのスクリプトを設定します。拡張を使わないコードなら簡単に動作します。先ほどの\ ``Dockerfile``\ と、ビルド部分はまったく同じです。
+一般的な\ ``Dockerfile``\ は、\ ``ENTRYPOINT``\ がシェル、\ ``CMD``\ がそのシェルから呼び出されるプログラムです。distrolessはシェルがなく、\ ``ENTRYPOINT``\ にNode.jsが設定されているので、\ ``CMD``\ にはJavaScriptのスクリプトを設定します。拡張を使わないコードなら簡単に動作します。先ほどの\ ``Dockerfile``\ と、ビルド部分はまったく同じです。
 
 .. code-block:: docker
    :caption: Dockerfile
@@ -401,7 +401,7 @@ distrolessはシェルが入っていおらず、外部からログインされ
 * CDNやオブジェクトストレージにアップする
 * Dockerコンテナとしてデプロイする
 
-このうち、CDNやオブジェクトストレージへのアップロードはそれぞれのサービスごとの作法に従って行ます。ここではDockerコンテナとしてデプロイする方法を紹介します。Dockerコンテナにするメリットはいくつかあります。主にテスト環境の構築画しやすい点です。
+このうち、CDNやオブジェクトストレージへのアップロードはそれぞれのサービスごとの作法に従って行ます。ここではDockerコンテナとしてデプロイする方法を紹介します。Dockerコンテナにするメリットはいくつかあります。主にテスト環境の構築がしやすい点です。
 
 デプロイ用のバックエンドサーバーをDocker化する流れは今後も加速していくでしょう。しかし、フロントエンドが特定のマネージドサービスにアップロードする形態の場合、デプロイ手段がバックエンドと異なるため、別のデプロイ方式を取る必要が出てきます。ちょっとしたステージング環境や、開発環境を構築する際に、フロントエンドもDockerイメージになっていて本番環境のCDNをエミュレートできると、ローカルでもサーバーでも、簡単に一式のサービスが起動できます。PostgreSQLのイメージや、Redisのイメージ、クラウドサービスのエミューレータなどと一緒に、docker-composeで一度に起動するとテストが簡単に行えます。
 
@@ -435,7 +435,7 @@ Dockerコンテナにする場合、ウェブサーバーのNginxのコンテナ
    COPY --from=builder /app/build public
    EXPOSE 80
 
-配信用のnginxの設定です。シングルページアプリケーションにとって大切なパートが\ ``try_files``\ です。シングルページアプリケーションでは1つのHTML/JSがあらゆるページを作り上げます。そしてその時にURLを書き換えます。しかし、そこでブラウザリロードをすると、JavaScritpによって作られた仮想的なURLを読みにこうとします。この\ ``try_files``\ を有効にすると、一度アクセスしに行って見つからなかった場合にオプションで設定したファイルを返せます。ここでは\ ``index.html``\ を返すので、そこでReact Routerなどのフロントで動作しているウェブサービスが仕分けを行い、もしどこにもマッチしなければフロント側のRouterがエラーをハンドリングできます。
+配信用のnginxの設定です。シングルページアプリケーションにとって大切なパートが\ ``try_files``\ です。シングルページアプリケーションでは1つのHTML/JSがあらゆるページを作り上げます。そしてその時にURLを書き換えます。しかし、そこでブラウザリロードをすると、JavaScriptによって作られた仮想的なURLを読みにこうとします。この\ ``try_files``\ を有効にすると、一度アクセスしに行って見つからなかった場合にオプションで設定したファイルを返せます。ここでは\ ``index.html``\ を返すので、そこでReact Routerなどのフロントで動作しているウェブサービスが仕分けを行い、もしどこにもマッチしなければフロント側のRouterがエラーをハンドリングできます。
 
 
 .. code-block:: nginx
@@ -597,7 +597,7 @@ minikubeのセットアップが終わったら、kubectlをインストール
    kubernetes                      ClusterIP   10.96.0.1       <none>        443/TCP   35m
    typescript-kubernetes-service   ClusterIP   10.107.196.16   <none>        80/TCP    7m10s
 
-作成したDeployment(複数のコンテナアプリケーションをまとめで管理できるリソース)とService(複数のコンテナアプリケーションをロードバランスしてくれるネットワークリソース)が稼働していることを確認したら、今度は動作を確認します。手元のシェルで \ ``kubectl port-forward``\ を実行し、Kubernetes上のアプリケーションを手元のブラウザで接続できるようにします。
+作成したDeployment(複数のコンテナアプリケーションをまとめて管理できるリソース)とService(複数のコンテナアプリケーションをロードバランスしてくれるネットワークリソース)が稼働していることを確認したら、今度は動作を確認します。手元のシェルで \ ``kubectl port-forward``\ を実行し、Kubernetes上のアプリケーションを手元のブラウザで接続できるようにします。
 
 .. code-block:: bash
 

docs/_sources/module.rst.txt

@@ -425,7 +425,16 @@ TypeScriptはインポートしたものが型だけの場合に、出力から
 
 インポートだけではなく、\ ``export type { A, B } from "./modules";``\ といった、インポートして即エクスポートする文においては、\ ``export``\ にも利用できます。
 
-現在リリースされているtypescript-eslintにおいても、\ ``import type``\ を使う方が推奨値としてデフォルト設定されています\ [#]_\ 。
+現在リリースされているtypescript-eslintの4.0以降においても、\ ``import type``\ を使うことを強制するルールが追加されました\ [#]_\ 。TypeScript 3.7以前ではすべてがエラーになってしまうため、デフォルトでは有効化されていません。
+
+.. code-block:: json
+   :caption: eslintrc.json
+
+   {
+     "rules": {
+       "@typescript-eslint/consistent-type-imports": "error"
+     }
+   }
 
 .. [#] 他に迷惑な有名なライブラリとしては、Pythonのthisがあります。\ ``import this``\ をするとPythonの設計思想を表す詩が表示されます。
 .. [#] https://github.com/typescript-eslint/typescript-eslint/blob/v4.1.1/packages/eslint-plugin/docs/rules/consistent-type-imports.md

docs/_sources/version.rst.txt

@@ -153,7 +153,7 @@ JavaScriptと比べたTypeScriptの場合、一番有利なのがここですね
 ライブラリやフレームワークを浅く使う
 ------------------------------------------------
 
-ライブラリやフレームワークを使う場合、メジャーな一般的な使い方からなるべく外さないようにします。間違ってもライブラリをラップして完全なオレオレフレームワークを作るとかすると、バージョンアップ時の作業が多くなります。また、メジャーな使い方に近づけておけば、ネットで情報を調べるときにも問題が発見しやすくなりますし、チームメンバーが途中から入ったとしても、実は最初から使い方を知っている、ということも期待できるかもしれません。
+ライブラリやフレームワークを使う場合、メジャーな一般的な使い方からなるべく外さないようにします。ライブラリをラップして完全なオレオレフレームワークを作るとかすると、バージョンアップ時の作業が多くなります。また、メジャーな使い方に近づけておけば、ネットで情報を調べるときにも問題が発見しやすくなりますし、チームメンバーが途中から入ったとしても、実は最初から使い方を知っている、ということも期待できるかもしれません。
 
 （参考）式年遷宮
 ------------------------------
@@ -214,4 +214,4 @@ JavaScriptと比べたTypeScriptの場合、一番有利なのがここですね
 
 常に更新しつづけるシステムであっても、バージョンの更新がおろそかになってしまうことがよくあります。バージョンアップは自社サービスであってもそうでなくても、保守として工数を確保して行う必要があります。影響を考慮してタイミングを見極めて行ったり、セキュリティ上必要であれば他の作業を止めてでも更新してデプロイなどスケジュールにも影響がありえる話になってきます。
 
-適切にコントロールすれば痛みを減らせる分野でもありますので、本性の内容を頭の片隅に置いといてもらえると幸いです。
+適切にコントロールすれば痛みを減らせる分野でもありますので、本章の内容を頭の片隅に置いといてもらえると幸いです。