Azure Web Sites の Site Extensions

  • Article

このポストは、6 月 20 日に投稿した Azure Web Sites Extensions の翻訳です。

Site Extensions としてデプロイされているツールは、Visual Studio Online などのソース コード エディターから、Web サイトに接続されている MySQL データベースなどの接続済みリソースの管理ツールまで、多岐にわたります。これらの強力なツールの利用を可能にするため、Azure Web Sites のそれぞれのサイトでは拡張可能な管理エンド ポイントを提供しています。既存の Site Extensions は、Azure 管理ポータル プレビューの各 Web Sites から使用できます。

お客様の Web サイトで使用する Site Extensions を新規作成する場合は、こちらのリンク (英語) の説明をお読みください。また、新しい Site Extensions をギャラリー投稿ポータル (https://www.siteextensions.net、英語) に投稿して、Azure Web Sites プラットフォーム全体で利用できるようにすることもできます。

既存の Site Extensions とのやり取り

既存の Site Extensions とやり取りするためのエントリ ポイントは、Azure 管理ポータル プレビューから、[Configuration] レンズの下の各 Web サイトで使用できます。Site Extensions の部分にアクセスすると、新しいブレードが開きます。

新たに追加する場合は、[ADD] ボタンをクリックして、追加する拡張機能をリストから選択します。これらの拡張機能はそれぞれ、拡張機能名の下に表示されている発行元から入手可能で、インストールの前に各発行元が提示する使用条項に同意する必要があります。

任意の Site Extensions を追加すると、そのコンテンツは Web サイトのルートに対応する %HOME%\SiteExtensions フォルダーにコピーされます。Site Extensions を追加すると、サイトは再起動されます。

インストール済みの Site Extensions へのアクセスと管理は、Site Extensions のリスト内のアイテムを右クリックするか、または各 Site Extensions のブレード上部に表示されているアクションから行うことができます。

Site Extensions の新規作成

Site Extensions はユーザーが作成することが可能で、さらにそれを共有することもできます。マイクロソフトは、皆様に Azure Web Sites ユーザーに向けて Site Extensions を公開していただきたいと考えています。

Site Extensions は、拡張機能を登録する簡単なメタデータを含む Web アプリケーションです。Azure Web Sites でサポートされている任意の開発スタックを使用して作成できます。こちらのページ (英語) のドキュメントにサンプルがありますので、ご参照ください。サイト構成によっては applicationHost.xdt ファイルを作成できますが、そのようなファイルが存在しない場合は、アプリケーションと Site Extensions の仮想ディレクトリを示す簡単なテンプレートが自動的に生成されます。

Site Extensions は、こちらのリンク (英語) で説明されているように NuGet 形式でパッケージ化されています。こちらから NuGet.exe コマンド ライン ユーティリティをダウンロードできますので、例として、簡単なサンプルの Site Extensions をパッケージ化してみてください。このサンプルのソース コードは、こちらのリンク (英語) でご覧いただけます。

  1. Site Extensions の名前のフォルダーを作成します。
  2. Web アプリケーションを作成し、この Site Extensions フォルダーの下にある Content フォルダーに関連するコンテンツをすべて格納します。
  3. 作成する Site Extensions 用の NuSpec ファイルを作成します。このとき、ライセンス条項へのリンクを必ず含めるようにします。そのサンプルはこちらのリンク (英語) でご覧いただけます。
  4. NuGet.exe ユーティリティにパスが通っていることを確認し、次のコマンドを Site Extensions フォルダーで実行して NuGet パッケージを作成します。

nuget pack example.nuspec

この nupkg 形式の Site Extensions を投稿して Azure Web Sites プラットフォーム全体で使用できるようにするには、投稿ポータル (https://www.siteextensions.net、英語) にアクセスします。このとき、投稿用のアカウントを登録する必要があります。

登録またはサインインが完了した後、Site Extensions のパッケージをアップロードして、投稿の詳細を確認します。

Site Extensions を作成することは、Azure Web Sites のコミュニティにとって非常に有意義なことですので、ぜひご協力ください。ご投稿いただいた Site Extensions のダウンロード状況は、ギャラリー ページ (https://www.siteextensions.net、英語) のそれぞれの Site Extensions のリンクから確認できます。また、新しい Site Extensions について、皆様が使用しているソーシャル メディアで宣伝していただけますと幸いです。