Install Guide jp
- 公式プロジェクトリンク : https://github.com/CloudBreadProject/CloudBread
- 公式プロジェクトフェイスブックグループ : https://www.facebook.com/groups/cloudBreadProject/
- 公式 API reference : http://cloudbreadproject.github.io/
この文書では、開発者に 向けた CloudBread プロジェクト、手続きを 紹介してあげます。CloudBread開発者ガイド関連文書は **CloudBread Projectのガイド**を参考にしてください。
この文書では、CloudBreadプロジェクト、手続きを紹介してあげます。次のような順番で進行可能です。
###CloudBreadの 設置準備事項
この文書は CloudBreadの 設置 作業前に 予め 行うべき 作業を 紹介します。
- Microsoft ID 加入後チェック: 加入有無の確認は、https://mail.live.comに接続してメールボックスが見えれば使用可能なアカウントです。
- Microsoft Azure 登録: CloudBreadは Microsoft Azure クラウドサービスのPaaSプラットフォームを利用して開発されました。CloudBreadを配布するためにまず、Azureの登録を遂行して無料登録は、次のリンクで遂行可能です。(Chrome ブラウザでは不可能であり、IEもバージョンによって設置ができないとします。) https://azure.microsoft.com/ko-kr/free/
- 無料でAzureを使用するため、追加的に、MSDN購読を したり 、Startup-BizSparkの加入者の場合にも無料で使用可能です。
- 2015年 4月に公開された Visual Studio Dev Essentialsで毎月充電される25$無料クレジットも可能です。
- Github 加入: https://github.com/で 加入 してください。 自分の Repositoryで Forkする 際に 必要します。
- Slack 加入: http://slack.com で加入して基本グループを設定してください。(CloudBread Scheduler サービスのお知らせ用途で基本として使用します。)
- ユニティ 開発者なら、Unity Studio 5.0 以上から 設置: Unity ダウンロード ページで受けることができます。
- Postman: http://www.getpostman.com/でダウンロード後Mac用、またはWindows Chrome用を設置します。
- Github Desktopの設置: https://desktop.github.com/で自分のOSに合う Github、デスクトップを設置します。
- SQL Server 2014 クライアント: AzureのSQL Database 管理のためのツールです。SQL 2014ダウンロードリンクで32ビットまたは64ビットバージョンに合った 管理ツールをダウンロードします。 "MgmtStudio 32BIT\SQLManagementStudio_x86.exe" または、"64BIT\SQLManagementStudiox64_KOR.exe"を選択して設置します。
- ゲームサーバ開発者なら、全体の機能を自分の 開発環境で使用するために管理ツールだけ設置するだけでなく ExpressAndTools 32BIT\SQLEXPRWT_x86JPN.exe または、 ExpressAndTools 64BIT\SQLEXPRWTx64_JPN.exe を選択して設置します。
- node.js 設置: https://nodejs.org/en/ サイトで v5.7 以上のStable バージョンをインストールします。(2016年 3月 基準 5.7.1 バージョン)
- Visual Studioコミュニティ 2015: Visual Studio 2015 コミュニティダウンロードで受けることができ、ページ下段用途に合わせてインストールしてください。(設置に30分ほど所要されます。)
- Visual Studio 2015アップデート: Visual Studioのアップデートページ(https://www.microsoft.com/en-US/download/details.aspx?id=49989)で、バージョンに合った設置が 可能です。
- Azure SDK 2.8 for Visual Studio 2015の 設置: Azure SDK ダウンロード ページで VS 2015 バージョン用 ダウンロードを 設置します。
この文書はARMを通じてリソース(SQL server、web app、mobile appなど)の配布を行うための方法を記述します。 配布は CloudBread-ARMでできます。
CloudBreadを配布の過程デモ映像: ARMを通じたサーバ配布
###配布の過程 1.CloudBread-ARM プロジェクトでforkを遂行。
2.[Deploy to Azure]ボタンをクリック。
3.パラメータの入力。
- postfix App Name: 生成するすべてのリソースの 固有の名前
- SQL server login ID: SQLログインに必要なID
- SQL server login password: SQLログインに必要な 暗証番号
パラメータの入力する時の注意点
| パラメータ | 注意事項 |
|---|---|
| postfix App Name | 16字以内の秒文字と数字 |
| SQL server login ID | 'admin'と使われるID使用不可 |
| SQL server login password | 8字以上。特殊文字を一つ 以上含む |
4.Resource group 生成。また、すでに作っておいたことがあったら使用可能。
-
配布約款検討同意する。
-
[Create] buttonで配布。
配布してから10分以内にすべてのリソースを使用することができます。 パラメータの入力に注意だけしていただければすべてのリソースが配布に成功することができます。
配布が完了すれば、次のようなMicrosoft Azureインスタンスが生成されます。例えば、"example"という名で配布した場合
| 役割 | Azure インスタンスタイプ | インスタンスの名前 |
|---|---|---|
| サービス グループ | リソース グループ(Resource Group) | 生成した リソースグループ名 |
| CloudBread サーバー | モバイル・アプリ(Mobile App) | example-cb-fe-ma-dev |
| Admin-Web サーバ | API アプリ(API App) | example-cb-adminweb-wa-dev |
| Socket サーバ | ウェブ アプリ(Web App) | example-cb-socket-wa-dev |
| ランキング、ソケットサーバ認証、大量のログの中間貯蔵施設 | Azure Redis Cache | example-cb-redis-dev |
| ゲーム データ 保存 | Azure SQL サーバ | example-cb-sqlsvr-dev |
| ゲーム データ 保存 DB | Azure SQL データベース | example-cb-sqldb-dev |
| ログ データ 保存 | 貯蔵所 勘定(Storage Accounts) | examplecbstrdev |
| Pushのお知らせ | お知らせのハブ name space | examplecbpushnndev |
| Pushのお知らせ | お知らせのハブ(Notification Hub) | example-cb-push-nh-dev |
| CloudBread、ソケット、 | ||
| Admin-Web サービス 計画 | アプリ サービスの 計画(App Service Plan) | example-cb-xxx-asp-dev |
| 上記のようなインスタンスがAzureに自動生成されます。 |
この文書では、CloudBreadをAzureに配布する過程を紹介します。
CloudBread Coreサーバ配布の過程デモ映像 : Mobile app 連続配布の過程
この過程前に、 すでにARMを通じてCloudBreadのサービスがAzureに成功的にインストールされたという前提のもとに以下の手続きを実行します。
次の手続きを通じて、さっき生成したサービスに CloudBreadを配布することができます。 CloudBreadは Azure モバイルアプリ (Mobile App) サービスを利用します。
- まず、https://github.com/CloudBreadProject/CloudBread リンクに 移動し、右上段のForkを遂行して自分のリポジトリにFork遂行 (配布に必須)
- 左側 上段 リソース グループで 生成した リソース グループを 選択
- リソースリストで生成した アプリ サービスのタイプの携帯アイコンの形のモバイル アプリを選択
- 掲示 - 連続 配布 選択
- 連続 配布で Github 選択
- 権限付与の項目に自分のgithubのアカウント確認
- 組織選択の部分に個人確認
- プロジェクトの選択に上の1回の過程でForkを遂行した自分のリポジトリのCloudBreadを選択
- 支店選択で、最近の ==2.x.x ブランチ==設定を 使用
上の過程を遂行したらすぐ配布が行われ、初めて遂行 する時5番目の過程でGithubログインを要求することができます。 一般的に5分以内に配布が完了されます。
Gitに慣れて自分のリポジトリで Visual Studioで開発を希望する場合はCloudBread wiki – https://github.com/CloudBreadProject/CloudBread/wiki 文書を参考にしてGit命令でローカルcloneして Visual Studioでプロジェクトを開き、web.configを 修正し、直ちに Visual Studioで配布すればいいです。
この文書はCloudBreadで必須的な接続 文字列(Connection String)乙処理する案を紹介します。
CloudBread接続文字列処理過程デモ映像 : DBアクセスのための鍵を取得します
接続文字列は ConnectionStringとして普通アプリケーションがデータベースやストレージにアクセスするためのアカウント 情報とサーバーの情報を含む文字列です。
CloudBreadは、データ処理のための基本のデータベースに Azure SQL Database, Key/Value 基盤NoSQLゲームログ保存所にAzure Table Storage、インメモリー (In-memory)Key/Valueの 基盤NoSQL貯蔵所でリーダーボード(ランキング)、ソケットサーバ認証、大量のログの処理の中間キューの貯蔵庫の用途で Redis Cacheを利用します。 各サービスの接続文字列をコピーしてアプリケーションで設定してこそ、正常的にCloudBreadサービスが起動 されます。
接続文字列があってこそ、CloudBreadアプリケーションがDBや貯蔵所と連動して完全に動作するように設定可能です。併せて、自身の装備でCloudBreadを追加・修正など開発された場合にも必ずこの連結文字列が必要です。
1.自分のポータルにログインします。 https://portal.azure.com、ログイン後生成したリソースグループを選択 2.SQLデータベースに生成されたAzure SQL Databaseを 選択 3.設定画面で データベース接続文字列表示の選択 4.右側に出た ADO.NET接続文字列全体を自分の notepadなどに保存
Azure SQL Database 接続文字列確認及びコピー 過程が完了しました。
- 自分のポータルにログインします。 https://portal.azure.com、ログイン後生成したリソースグループを選択
- 形式が貯蔵所のアカウントで生成されたAzure Table Storageを選択
- 設定画面で右ブレードのアクセスキーを選択した後、接続 文字列全体を自分のnotepadなどに保存
Azure Table Storage接続文字列確認及びコピー 過程が完了しました。
- 自分のポータルにログインします。 https://portal.azure.com、ログイン後生成したリソースグループを選択
- 形式が Redis Cacheに生成されたAzure Redis Cacheを選択
- 設定画面で キー -アクセスキー 表示の選択
- 右側ブレードの*Primary connection string (StackExchange.Redis)*の連結文字列全体を自分の notepadなどに保存
Redis Cache接続文字列確認及びコピー過程が完了しました。
もうDBのオブジェクトのインストール過程が必要です。
この文書は CloudBreadで必須的なデータベースのオブジェクト を生成する方案を紹介します。
CloudBread データベースの設置スクリプトの遂行過程 デモ映像 : DBのオブジェクト生成
CloudBreadは内部的にデータ処理のため、Azure SQL Databaseを利用します。このAzure SQL Databaseで ビジネスロジックを処理するための様々なオブジェクトを 自動的に生成する過程を実行します。この自動設置の ためにはWindows コマンドプロンプトでbatchファイルを実行し、SQLCMDを通じた設置を実行します。
SQLCMDは基本準備事項で知らせたSQL Server 2014 クライアントツールに 含まれています。すでに設置したらSQLCMDを追加設置する必要がありません。SQL Server 2014クライアントはデータベースを連結してから情報を見たり開発及びテストに利用される立派なツールであり、必須推奨設置の事項です。もし、SQL Server 2014 クライアントを設置しない聞きになった 場合、SQLCMDを設置すればいいです。 SQLCMDダウンロードリンク - https://www.microsoft.com/en-us/download/details.aspx?id=36433 もし、ODBC設置が必要とする場合にはODBC設置後再び SQLCMD設置を遂行すればいいです。 ODBCドライバーの インストールリンク: https://www.microsoft.com/en-us/download/details.aspx?id=36434
スクリプトをスヘンハする時前、自分のAzure SQL Databse接続文字列を通じて" サーバ アドレス"、"データベースの 名前"、"SQL ログイン ID"、" SQL ログイン 暗号"が 必要です。すでに持ってきてnotepadにコピーしておいたAzure SQL Database接続文字列は普通 次のような形式です。
connectionString="Server=tcp:**サーバアドレス**,1433;Database=**データベースの名前**;User ID=**SQLログインID**;Password=**SQLログイン暗号**;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
上のコードで ごらんのように、自分の"サーバアドレス"、"データベースの名前"、"SQL ログイン ID"、"SQL ログイン 暗号"を notepadなどにコピーし、以下の手続きを実行します。
- CloudBread DBの設置リポジトリに移動します。 https://github.com/CloudBreadProject/CloudBread-DB-Install-Script
- 右 上段のForkを遂行して自分のリポジトリにコピーします。
- 自分のリポジトリでdownloadしたりgitが慣れた場合 cloneしてローカルにコピーします。
- ウィンドウでコマンドプロンプトを実行します。 ウィンドウキーを押して"cmd"と入力すれば、すぐ見えます。
- 命令プロンプトで次のコマンドを遂行して、そのフォルダに移動します。
cd "CloudBread-DB-Install-Script ダウンロード 後、圧縮を 解除した 経路
- 次のコマンドを遂行してAzure SQL サーバーに接続されるかチェックします。
ping-test.bat サーバ アドレス SQLログインID SQLログイン暗号 データベースの 名前
サーバを見つけることができなかったり、ファイアウォール制限(Firewall)エラーが発生することができます。これを解決に向けてAzure ポータル - 生成した リソース グループ - SQL Server-の設定画面で、ファイアウォール設定の表示を 選択して、一番上の クライアントIPアドレス追加を 押します。 pingコマンドの実行するときサーバのversion情報が 見えれば、首脳の連結です。もし、SQLCMDを捜すことが できないと出たら "C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools\Binn" 経路に一般的にSQLCMDが存在します。(インストール経路は私と違うことができます) 次のコマンドでpathを 登録して再びping命令を実行します。
path "C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\110\Tools\Binn"
正常に結果が出たら成功です。
- 次のコマンドを遂行してCloudBread DBのオブジェクトを自動インストールします。
install-with-sample.batサーバアドレスSQLログイン ID SQL ログイン暗号データベースの名前
何のエラーメッセージがない場合、正常実行されたことです。
データベースオブジェクトの生成過程が完了しました。
次に、CloudBread設定過程が必要です。
この文書はCloudBreadをクラウドで配布後設定する過程を紹介します。
CloudBread設定過程デモ映像 : 生成された DBに appアクセス
注: 映像ではCloudBreadSocketRedisServer部分だけ 構成しています。CloudBreadRankRedisServerと CloudBreadGameLogRedisServerも必ずApp Settingに 入れてこそ、正常に動作します
CloudBread coreサーバアプリケーションでデータベースと貯蔵施設に接近するためのアカウント情報とサーバーの 情報をCloudBread coreサーバーに設定する過程を遂行してこそ、正常動作します。
両 方法の一つを選んで遂行してください。
- オプション 1. Azure モバイルアプリの 応用 プログラム 設定 項目 - 連結 文字列の 項目と アプリ 設定 項目に設定する方法、 今回のユニティキャンプで利用することを推奨します。
- オプション 2. CloudBreadプロジェクトをgit cloneまたは ダウンロード 後 Visual Studioの ルートに位置したweb.configファイルを修正後すぐに自分のAzureモバイルアプリで配布する案であり、サーバ開発者であったり、開発を希望する場合、推薦します。
Azure・ポータルで設定する過程を詳細に紹介してあげます。
- 必須的に構成しなければならない連結文字列設定。CloudBreadが配布された Azure モバイルアプリの応用 プログラム 設定項目 - 連結 文字列の項目 とアプリ 設定に移動。
- 接続文字列部分に、その下の値を入力 - notepadにコピーしておいた接続文字列活用
- 必須 設定- 連結文字列設定
| 設定名 | 接続文字列値 | 追加設定 | 項目の説明 |
|---|---|---|---|
| CloudBreadDBConString | Azure SQL Database 接続文字列値 | SQL データベース | データベース 接続に使用 |
| CloudBreadStorageConString | Azure Table Storage 接続文字列値 | 使用者 指定 | 貯蔵所アカウントの連結に使用 |
-
注意事項で、Azure SQL Databaseの接続文字列 ==password== 部分が基本です。 {your_password_here} 形になっています。 この部分を中括孤から全てを消して必ず修正してください。
-
連結文字列設定項目のすぐ上のアプリ設定項目に以下の 項目入力
-
必須 設定 - アプリ 設定
設定名|値|説明 ---|---|---|--- CloudBreadSocketRedisServer|Redis Cache 接続文字列|このKEYはCloudBread-Socketプロジェクト認証トークンを保存するRedisに接続するときに使用されます。 CloudBreadRankRedisServer|Redis Cache 接続文字列|この KEYは leader board(ranking) サービス 連結に 使用されます。 CloudBreadGameLogRedisServer|Redis Cache 接続文字列|この KEYは redisをゲームログサービスで設定する 場合(下CloudBreadLoggerSettingと 連動)の連結に使用
- 選択設定項目 下値は、選択項目です。 基本値が設定されているので、別途に設定する必要がなく、設定変更の 際は利用されるので、参考にしてください。
| 設定名 | デフォルト値 | 説明 |
|---|---|---|
| CloudBreadCryptSetting | AES256 | 暗号化方式設定 |
| CloudBreadLoggerSetting | ATS | 基本ログの貯蔵方式は Azure Table Storageですぐに保存。SQL、AQS、redis 設定に保存位置変更可能。CBLogger.cs参照 |
| CloudBreadconRetryCount | 3 | DB接続トライ数。 Production環境でスロトゥルリンハンドルを向けて30の設定、おすすめ。最大30秒間隔で3回の試み。 |
| CloudBreadconRetryFromSeconds | 5 | DB 接続 やり直し待機 時間秒 Production環境でthrottling ハンドルを 向けて 3に 設定、おすすめ。最大 30秒 間隔で 3回の 試み。 |
| CloudBreadRankSortedSet | cbrank | Redisに 保存される rank機能処理 Redis Sorted Setの名前 |
| CloudBreadFillRedisRankSetOnStartup | true | 最初の 開始時、redis cacheにrank情報を満たす処理 実行するかどうか |
| CloudBreadGameLogExpTimeDays | 365 | redisにログデータ積載時ログデータ基本ジョジャンイル(ゲームログ保存in-memory queueサービスで使用されるものであり、SchedulerによってbatchでAzure table Storageで保存するパターン) |
CloudBread設定が完了しました。
ここまでに完了したら、もう CloudBreadを開発/テストツールであるPostmanの URLを一括変更すればいいです。
- https://github.com/CloudBreadProject/CloudBread/wiki/Home-jp リンクでPostman collectionファイルを ダウンロードします。
- ダウンロード後、collection ファイルをnotepadなどで開いて (Jsonの フォーマット) 従来のテスト URLを 直接構成するサーバーのURLで一括変更(Find&Replace)します。
Postman collectionでCloudBreadは三つのdemoサーバリンクを提供します。
- https://cb2-demo.azurewebsites.net/ : 一般 Postmanテストサーバー
- https://cb2-auth-demo.azurewebsites.net/ : Postmanの認証テストサーバー
- https://cb2-crypt-demo.azurewebsites.net/ : Postman 暗号化 テストサーバ 上のリンクをすべて構成したサーバーのアドレスに Postman collectionファイルで変更してください。(Demoの目的に三つのサーバに分かれているが、実際の構成したサーバはconfig 設定の変更だけで全て使用可能です) 変更が完了すれば、保存してPostmanを開けば自分が 直接構成したサーバとPostman連結して開発及びテストが 可能です。
次にCloudBread Socketの配布と設定が必要です。
この 文書は、リアルタイム、双方向 通信を 行うための CloudBread-Socket プロジェクトの 設置 方法について 記述します。 (もし、リアルタイム、双方向 通信(Peer-to-Peer)機能を 利用していない場合は 設置しなくても いいです。)
CloudBread-Socketサーバーのインストール過程デモ 映像: ソケットサーバ設置
- Node.js 4.x or 5.x 以上及び NPM 3.x 以上 []ダウンロードリンク](https://nodejs.org/en/)
- Git Client []ダウンロード リンク](https://git-scm.com/downloads)
tip 過去 Node.jsをインストールした場合、バージョンが低く、支援されないことがあります。 命令プロムポトゥ(ウィンドウ)やターミナル(Unix)をつけてnode-v、npm-v コマンドを入力してバージョンを確認することができます。
git clone https://github.com/CloudBreadProject/CloudBread-Socket.git
cd CloudBread-Socket
npm i上の過程が成功的に終わったらnode_modulesというフォルダが生成されます。
npm test下記のように結果が出るなら、完璧です。
> mocha tests/* --require babel-core/register --require babel-polyfill --require ./tests/helper --recursive
The server is listening at http://localhost:8111
Server
✓ is a object
✓ says hello worlds!
2 passing (123ms)エラーが発生した場合、きちんと設置に至らなかったことです。
npm startこのコマンドは、アプリを実際のサービスする前にローカルでテスト環境を構築する際に有用です。
基本的に 8222 ポートにサーバーが開かれます。 tools/config.js ファイルのPORT定数を修正したり
npm start -- --port 8888コマンドに --port 因子を付与してポートを変更する ことができます。
tools/tasks/deploy.jsを VI、Atom、Sublime Text、EditPlus、Notepad++などのテキストエディタで開きます。 12 ~ 16番列の間に次のような内容がありそうです。
const remote = {
name: 'azure',
url: 'https://[email protected]:443/hbh-cloudbread-socket.git',
website: 'http://hbh-cloudbread-socket.azurewebsites.net',
};上の項目でurl、website項目を、本人の環境に合わせて 修正します。
urlはウェプエプと連結されたレポジトリのアドレス、websiteはウェプエプのアドレスです。 管理者ポータルの情報項目で URL => website、Git clone url => url です。
AZURE WEB管理者ポータルでウェブアプリ設定でアクセスします。 ソケットを Offで Onに変更します。
修正が終わったら次のコマンドを実行します。
npm run deploy以後、パッケージを自動的にProductionの形でビルドした 後、Gitクライアントを通じて連結されたアドレス宛に 配布します。 配布するPCに配布サーバと繋がったSSH Keyがなければ、パスワードを尋ねます。
この項目は実際のサービスする 際に、設定が必要です。 単純 テスト段階ではこの段階を遂行する必要がありません。
Azure web管理者ポータルでウェブアプリ設定でアクセスします。 アプリ設定に次のような環境変数を追加します。
-
REDIS_HOST=> レディース ホスト アドレス -
REDIS_PORT=> レディース ポート -
REDIS_AUTH_KEY=> レディース 認証 キー
以降、アプリを再起動すれば、ユーザが接続する際にトークンを要求します。 CBで認証する場合、レディースに自動的にトークンが生じ、該当トークンを接続する際一緒に 伝えてくればいいです。
###CloudBread Schedulerサービス 配布 この文書はCloudBreadでSchduler Batchの役割を担当するCloudBread-Schdulerの配布の手続きを説明します。
CloudBread-Schedulerの ンストール過程デモ映像 : スケジュル サービス 連動
###CloudBread-Schedulerの配布の手続き紹介 CloudBread SchedulerはAzureのWebJobを利用して作りました。 2016年 3月 現在、WebJobの最も効率的な方法はVisual Studioを利用してPublish as Azure WebJobをCloudBread-Admin-Webにつけて配布する方策です。 別のアプリを追加で生成せず、このようにアプリサービスと 一緒に配布する方式で処理されます。
###CloudBread-Schedulerを分離して設置 上のCloudBread-Admin-Webにつけて配布する方式は、推薦する開発/テスト 方法であり、もし、大規模な配置を 遂行するSchedulerサービスである場合一つの空いたウェブアプリを追加後ウェブ要請がないようにweb.configを 構成後、CloudBread Scheduler向けに構成することを 推奨します。ウェブアプリのアプリサービスの計画によってbatchサービスの大きさも一緒にスケールアップ/スケールアウトできます。(singleton 設定 参照)
WebJobは Triggerによって動作するようになる 仕組みで、WebJobの内部で Timer Triggerを利用して cron方式でtriggerが発生し、当該時刻に作業する内訳を すぐ Azure Queue Storageという queue保存所(名前はcloudbread-batch)でメッセージを送ります。この queueにメッセージが到着すると、WebJobのqueue triggerによって自動的にqueueのメッセージを持ってきて該当メッセージのJobIDを読んでbatchを実行します。Timerトリガを利用してこのbatchらはすべてSingleton作業で実行され、(2016年3月)の履行が完了すれば、お知らせサービスを利用して自動的にSlack(基本)または GMailで伝えられており、Slackを利用する方式を推奨してあげます。2016年3月 現在、GMailは "信頼 できない 機器で ログイン "メッセージが 発生します。 - https://www.google.com/settings/security/lesssecureapps Gmailのセキュリティを下げる設定すれば正常 動作なります。
先に、すでに加入してきたSlackにログインします。 次のリンクでIncoming Web Hookを構成します。https://my.slack.com/services/new/incoming-webhook/ つまり、batchが終わると自動でメッセージが導入されることがslack チャンネルを選択します。 処理すれば、Channel webhook URLが生成され、この URLとチャンネルをnotepadにコピーしておいてください。全体URLをそのまま利用します。
https://hooks.slack.com/services/abcd/abcd/abcdefghgh
Slack Incoming Webhook 参考 リンク https://api.slack.com/incoming-webhooks
2016年 3月 推奨する - Visual Studioで設定する手順は、下記を遂行してください。
- https://github.com/CloudBreadProject/CloudBread-Scheduler リポジトリで右上段のForkを遂行して自分の リポジトリで取得します。
- CloudBread SchedulerリポジトリのBranchで最新の ==2.x.xブランチ==を選択して、
- 該当Branchをgit cloneまたはダウンロード
- Visual Studioのソリューションファイルを開き、ルートに位置したApp.config ファイルを下の手続き通り修正
- CloudBread AdminWebウェブアプリにWebJobに配布する案です。 配布策がいくつか追加で存在するが、現時点で最も効率的な方法でお勧めします。 他の方式のように、Azure Portalで構成したらVisual Studio config設定より優先することになります。
- 必須 設定 - 連結 文字列 設定 過程
| 設定名 | 接続 文字列値 | 追加 設定 | 項目の 説明 |
|---|---|---|---|
| AzureWebJobsDashboard | Azure Table Storage 接続 文字列 | 使用者 指定 | 貯蔵所 アカウントの連結に使用 |
| AzureWebJobsStorage | Azure Table Storage 接続 文字列 | 使用者 指定 | 貯蔵所 アカウントの連結に使用 |
| CBSchedulerDBConnectionString | Azure SQL Database 接続 文字列 | SQL データベース | データベース 接続に使用 |
| notepadにコピーしておいた接続文字列を再使用して構成します。 |
- 必須 設定 - アプリ 設定 過程
| 設定名 | 設名 |
|---|---|
| CBNotiEmailSenderID | Gmail ID |
| CBNotiEmailSenderPassword | GMail PWD |
| CBNotiEmailSendToEmail | メール受信者Email Address –batch作業後チームや管理者グループのメールに設定 |
| CBNotiSlackWebhookURL | 上で生成したWebhook URL選択 |
| CBNotiSlackChannel | Webhookを受けるように構成した チャンネル設定 |
| CBNotiSlackUserName | メッセージした人で表示することがSlack User Name |
- 選択設定項目の処理過程の下、値は、選択項目です。 基本値が設定されているので、別途設定する必要がなく、設定変更の際は利用されるので、参考にしてください。
| 設定名 | デフォルト値 | 項目の 説明 |
|---|---|---|
| CloudBreadconRetryCount | 3 | DB接続トライ数。 Production環境でスロトゥルリンハンドルを向けて30の 設定、おすすめ。最大30秒間隔で3回の試み。 |
| CloudBreadconRetryFromSeconds | 5 | DB接続やり直し待機時間秒Production環境でthrottlingハンドルを向けて3に設定、おすすめ。最大30秒間隔で3回の試み。 |
このすべての構成を完了したら、Visual Studioで Publish as Azure WebJobを遂行して配布します。
- 遊休状態でも実行 Web Jobを行い、ログを見ると、このようなメッセージが 出て、スケジュルロサービスが止められいます。
[03/01/2016 17:37:22 > 5a3d2c: SYS INFO] WebJob is stopping due to website shutting down
[03/01/2016 17:37:22 > 5a3d2c: SYS INFO] Status changed to Stopping
[03/01/2016 17:37:23 > 5a3d2c: SYS INFO] Status changed to Success
[03/01/2016 17:37:23 > 5a3d2c: SYS INFO] Status changed to Stopped
[03/01/2016 18:11:27 > 5a3d2c: SYS INFO] Status changed to Starting
[03/01/2016 18:11:27 > 5a3d2c: SYS WARN] 'Always On' doesn't appear to be enabled for this Web App. To ensure your continuous job doesn't stop running when the SCM host is idle for too long, consider enabling 'Always On' in the configuration settings for your Web App. Note: 'Always On' is available only in Basic, Standard and Premium modes.
上でごらんのように、遊休状態の場合、サービスが終了したというイベントが浮上し、サービスが中止されます。 アプリ設定の 応用プログラム設定 - いつも使用 設定をつけたら、サービスが維持されます。 いつも使用 設定は基本のインスタンスの大きさ以上から支援します。
Azure Scheduler構成と配布過程が完了しました。 次にCloudBread Admin Web配布の過程を実行します。
この 文書では、CloudBread-Admin-Webを ウェプエプに 配布する 過程を 紹介します。
CloudBread-Admin-Webのインストール過程デモ映像 : admin web 連続 配布
次の手続きを通じて、さっき生成したサービスに CloudBread-Admin-Webを配布することができます。 CloudBreadはアプリサービスの ウェブ アプリ を利用します。
- 先に、https://github.com/CloudBreadProject/CloudBread-Admin-Web リンクに移動し、右上段の Forkを遂行して自分のリポジトリで、フォーク遂行(配布に 必須)
- https://portal.azure.com に接続 後の 左側上段 リソース グループで生成したリソースグループを選択
- リソースリストで生成した アプリサービスのタイプの地球儀アイコンの 形、ウェブアプリ 選択
- 掲示-連続 配布 選択
- 連続配布で Github選択
- 権限付与の項目に自分のgithubのアカウント確認
- 組織選択の部分に個人確認
- プロジェクト選択で上の1回の過程でForkを遂行した自分のリポジトリのCloudBread-Admin-Webを選択
- 地点選択で 、最近の ==2.x.xブランチ== 設定を使用
上の過程を遂行したらすぐ配布が行われ、初めて遂行の 時5度の過程でGithubログインを要求することができます。 一般的に5分以内にしばらくして配布が完了されます。
Gitに慣れて自分のリポジトリで Visual Studioで開発を 希望する場合は、CloudBread wiki - https://github.com/CloudBreadProject/CloudBread/wiki文書を参考にしてGit命令でローカルcloneして Visual Studioでプロジェクトを開き、web.configを修正し、直ちにVisual Studioで配布すればいいです。
TODO
