Docker を使った SharePoint Framework 開発環境の構築 その3

投稿者: | 2019年12月8日

はじめに

Docker 上に SharePoint Framework の開発環境を構築する手順をまとめました。
この資料の内容は、こちらのスライドからの抜粋となります。
構築手順をまとめて確認したい方は、スライドをダウンロードしてください。

なお、環境構築手順は、
開発環境を構築するためにホストとなる PC で行う手順
Docker イメージを準備する手順
Docker 上でプロジェクトごとに行う手順
の3部構成になっています。

この記事では、Docker 上でプロジェクトごとに行う手順について記載します。

Docker 上でプロジェクトごとに行う手順

プロジェクトフォルダの作成

Docker で Shared Drive として指定したドライブに、SharePoint Framework 開発用の作業フォルダを作成し、その作業フォルダの下にプロジェクト用のフォルダを作成します。

Docker コンテナの起動

開発環境として使用する Docker コンテナを起動するため、PowerShell で以下のコマンドを実行します。

以下、実行コマンドの例です。

 

各種モジュールのインストール

Docker コンソールにて、以下のコマンドを実行して必要なモジュールをインストールします。
なお、こちらの手順は、Docker イメージを waldekm さんの Docker Hub から取得した場合のみ行ってください。
私が作成したイメージ及び Dockerfile は、こちらのインストールが済んだ状態になっているので実行不要です。

プロジェクトの作成

続いて、以下のコマンドを実行してプロジェクトを作成します。
yo コマンドを実行すると色々と質問が表示され、それに回答していくとプロジェクトが作成されます。
Web パーツ開発、拡張機能開発により、質問への回答の仕方が異なってくるのですが、その辺りは別記事で紹介したいと思います。

なお、このコマンドを実行すると SharePoint Framework 開発に必要な各種ソースコードや設定ファイルがダウンロードされるのですが、この際に環境によってはエラーが発生する可能性があります。
一部ではありますが、エラーが発生した場合の対応や、追加で行わなければならない設定などを別記事でまとめているので、行き詰った方は参考にしてください。

Docker で SharePoint Framework 開発環境を構築する際の注意事項
SharePoint Framework v1.7.0, v1.7.1 Docker image 使用時の注意点

 

開発証明書の作成、インストール

続いて、以下のコマンドを実行して開発用証明書を作成します。

コマンド実行後、開発サーバーが起動するので、ローカル PC の Internet Explorer で  https://localhost:4321  を開いて、証明書をインポートします。
証明書のインポート先には「信頼されたルート証明機関」を指定してください。
なお、証明書のインポートは実施しなくても特に大きな支障はありません。

 

以上で、プロジェクトごとに行う環境構築は完了です。
この後また別記事で、Web パーツなどプロジェクトの種類ごとに開発方法などを掲載していきたいと思います。

慣れればそうでもないのですが最初は大変な作業だと思いますので、何度か繰り返して体を慣らして、SharePoint Framework ライフを楽しみましょう!