>  > ディクセル ブレーキローター PD(プレーンディスク) フロント左右セット コンチェルト/ドマーニ MB5 3312759 DIXCEL ディスクローター ブレーキディスク【店頭受取対応商品】
HKS エッチ・ケー・エス SUPER FIRE RACING M40XL 3本セット アルト/アルトワークス TURBO HA36S R06A 15/3~ XLタイプ NGK8番相当 プラグ

ディクセル ブレーキローター PD(プレーンディスク) フロント左右セット コンチェルト/ドマーニ MB5 3312759 DIXCEL ディスクローター ブレーキディスク【店頭受取対応商品】

MicroBatchFramework – クラウドネイティブ時代のC#バッチフレームワーク

Posted on

Cy#の河合です。昨年12月に、『MagicOnion』というライブラリのリリースを告知しました。今回、再びオープンソースライブラリとして、C#のためのCLI/Batchライブラリをリリースしました。

[GitHub – Cysharp/MicroBatchFramework]

.NET CoreになってWindows/Mac/Linux問わずクロスプラットフォームなアプリケーション開発環境として機能するようになったC#ですが、

ディクセル ブレーキローター PD(プレーンディスク) フロント左右セット コンチェルト/ドマーニ MB5 3312759 DIXCEL ディスクローター ブレーキディスク【店頭受取対応商品】新品入荷します!

、そして機能的には十分揃っているのですが、ちょっと気の利いたフレームワークは意外と欠けているところがあります。バッチ・コマンドラインアプリ。というと地味なトピックスですが、ゆえに基本機能以上のサポートがなかったりします。しかし、「C#の可能性を切り開いていく」という理念を掲げるCy#としては、派手・地味を問わず、現状のC#に欠けているものを埋めていくことで、C#がアプリケーションを作る環境として、より良いものなるようにしたいと思っています。

ディクセル ブレーキローター PD(プレーンディスク) フロント左右セット 2006年12月~2012年04月 コンチェルト/ドマーニ ワイルドステッチ MB5 3312759 DIXCEL ディスクローター ブレーキディスク【店頭受取対応商品】

すでにC#にはコマンドライン引数の解析ツールはたくさんあります。とはいえ、そもそもそういうツールを使う時は「コマンドライン引数の解析」がしたいわけではなくて 、「パラメータバインディング」をしたいのが一般的と思われます。ということで、『MicroBatchFramework』はウェブフレームワークのようにメソッドを呼び出してくれる仕様にしました。

class Program
{
 static async Task Main(string[] args)
 {
 // エントリポイント。この1行でフレームワークのStartup設定は終わりです。
 await BatchHost.CreateDefaultBuilder().RunBatchEngineAsync<MyFirstBatch>(args);
 }
}
// 実際のバッチの定義
public class MyFirstBatch : BatchBase // BatchBaseを継承してもらって
{
 // void(同期)かTask(非同期)の戻り値が設定可能、パラメータはどんな型も自由(JSONからマッピングします)
 public void Hello(string name, int repeat = 3)
 { 
 for (int i = 0; i < repeat; i++)
 {
 this.Context.Logger.LogInformation(

MicroBatchFramework – クラウドネイティブ時代のC#バッチフレームワーク

Posted on

Cy#の河合です。昨年12月に、『MagicOnion』というライブラリのリリースを告知しました。今回、再びオープンソースライブラリとして、C#のためのCLI/Batchライブラリをリリースしました。

[GitHub – Cysharp/MicroBatchFramework]

.NET CoreになってWindows/Mac/Linux問わずクロスプラットフォームなアプリケーション開発環境として機能するようになったC#ですが、そして機能的には十分揃っているのですが、ちょっと気の利いたフレームワークは意外と欠けているところがあります。バッチ・コマンドラインアプリ。というと地味なトピックスですが、ゆえに基本機能以上のサポートがなかったりします。しかし、「C#の可能性を切り開いていく」という理念を掲げるCy#としては、派手・地味を問わず、現状のC#に欠けているものを埋めていくことで、C#がアプリケーションを作る環境として、より良いものなるようにしたいと思っています。

CLIツールのためのフレームワーク

すでにC#にはコマンドライン引数の解析ツールはたくさんあります。とはいえ、そもそもそういうツールを使う時は「コマンドライン引数の解析」がしたいわけではなくて、「パラメータバインディング」をしたいのが一般的と思われます。ということで、『MicroBatchFramework』はウェブフレームワークのようにメソッドを呼び出してくれる仕様にしました。

class Program
{
 static async Task Main(string[] args)
 {
 // エントリポイント。この1行でフレームワークのStartup設定は終わりです。
 await BatchHost.CreateDefaultBuilder().RunBatchEngineAsync<MyFirstBatch>(args);
 }
}
// 実際のバッチの定義
public class MyFirstBatch : BatchBase // BatchBaseを継承してもらって
{
 // void(同期)かTask(非同期)の戻り値が設定可能、パラメータはどんな型も自由(JSONからマッピングします)
 public void Hello(string name, int repeat = 3)
 { 
 for (int i = 0; i < repeat; i++)
 {
 this.Context.Logger.LogInformation($"Hello My Batch from {name}");
 }
 }
}

これは `SampleApp.exe -name “foo” -repeat 5` で呼び出すことが可能、という仕様です。

// 引数に別名や説明をつけたり
public void Hello(
 [Option("n", "name of send user.")]string name,
 [Option("r", "repeat count.")]int repeat = 3)
{
 // ...omit
}
// サブコマンドの作成や、引数順番でもバインディングなどをサポート
[Command("escape")]
public void UrlEscape([Option(0)]string input)
{
 Console.WriteLine(Uri.EscapeDataString(input));
}

煩わしい定型的な引数の解析に悩まされることなく、メソッドだけ定義すれば、あとはすべてよしなにやってくれます。

.NET Coreで作成したアプリは、ランタイムのインストールも不要な実行ファイルを Windows/Linux/Mac向けに作ることができます。また、CIに関してもCircleCIのようなコンテナベースのCIを、他の言語と遜色なく利用することが可能です。例えば以下のような記述で、実行ファイル生成をCIに任せられます。

version: 2.1
executors:
 dotnet:
 docker:
 - image: mcr.microsoft.com/dotnet/core/sdk:2.2
 environment:
 DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
 NUGET_XMLDOC_MODE: skip
jobs:
 publish-all:
 executor: dotnet
 steps:
 - checkout
 - run: dotnet publish -c Release --self-contained -r win-x64 -o ./MicroBatchSample/win-x64
 - run: dotnet publish -c Release --self-contained -r linux-x64 -o ./MicroBatchSample/linux-x64
 - run: dotnet publish -c Release --self-contained -r osx-x64 -o ./MicroBatchSample/osx-x64
 - run: apt update && apt install zip -y
 - run: zip -r MicroBatchSample.zip ./MicroBatchSample
 - store_artifacts:
 path: MicroBatchSample.zip
 destination: MicroBatchSample.zip
workflows:
 version: 2
 publish:
 jobs:
 - publish-all

この辺りは、もはやC#だからといってWindowsに縛られたり、使えるシステムに制約があったりということはなく、自由に組み合わせていくことができる証左と言えるでしょう。

また、配布に関しては.NET CoreグローバルツールというNPM Global Toolsのような仕組みも用意されています。例えば以下のようなUlid生成のためのツールをMicroBatchFrameworkと.NET Coreグローバルツールで作ってみました。

これにより、dotnetコマンドが使える環境に対するCLIツールの配布、管理が容易になっています。

バッチのためのフレームワーク

C#とバッチはけっこう相性が良いと思っています。その最たるところは並列処理で、とりあえず実行時間かかりそうなものはParallelにするだけで、バッチ突き抜け率を大幅に低減することができます。

// これを
foreach(var item in foo)
{
// なんかたくさん処理する
}
// こうするだけ
Parallel.ForEach(item =>
{
// なんか色々やる
});

というのはともかく、実際にプロダクトで使うバッチ処理は複数、むしろ山のように用意することがほとんどだと思います。それらを単一のコンソールアプリケーションで効率よく管理できるように、クラスとメソッドを定義するだけで出し分けられるシステムを用意しました。

class Program
{
 static async Task Main(string[] args)
 {
 // <T>を渡さないと複数検索モードになる
 await BatchHost.CreateDefaultBuilder().RunBatchEngineAsync(args);
 }
}
// こんなクラスや
public class Foo : BatchBase
{
 // こんなメソッドや
 public void Echo(string msg)
 {
 this.Context.Logger.LogInformation(msg);
 }
 // こんなメソッドを
 public void Sum(int x, int y)
 {
 this.Context.Logger.LogInformation($"{x + y}"); 
 }
}
// こんなクラスを
public class Bar : BatchBase
{
 public void Hello2()
 {
 this.Context.Logger.LogInformation("H E L L O");
 }
}

このように、第1引数によって実行するメソッドを切り替えられます。

SampleApp.exe Foo.Echo -msg "aaaaa"
SampleApp.exe Foo.Sum -x 100 -y 200
SampleApp.exe Bar.Hello2

さて、こうして出来たアプリケーションは、コンテナ化するのをお薦めします。.NET CoreならばC#でもコンテナ化は簡単です。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS sdk
WORKDIR /workspace
COPY . .
RUN dotnet publish ./MicroBatchFrameworkSample.csproj -c Release -o /app
FROM mcr.microsoft.com/dotnet/core/runtime:2.2
COPY --from=sdk /app .
ENTRYPOINT ["dotnet", "MicroBatchFrameworkSample.dll"]

例えばこれをAWS ECRにCircleCIで上げるなら、以下のようなコンフィグになるでしょう。

version: 2.1
orbs:
 aws-ecr: circleci/aws-ecr@3.1.0
workflows:
 build-push:
 jobs:
 # see: https://circleci.com/orbs/registry/orb/circleci/aws-ecr
 - aws-ecr/build_and_push_image:
 repo: "microbatchsample"

非常にシンプルに書けるし、C#だからといって特別なことはなく、一般的なエコシステムに乗っているわけです。

こうして上がったコンテナは、あとはただのコンテナなので好きなように実行すればいいわけですが、例えばAWS Batchを使えば比較的シンプルに実行もスケジューリング(CloudWatchでイベントトリガを設定可能)も定義可能です。そして、ログはCloudWatchで標準出力が確認できます。

複雑なワークフローを定義したい場合は、別途LuigiApache Airflowが使えるはずです。

Swaggerによるウェブインターフェイス

開発時など、いちいちコマンド打って確認するのも面倒な場合もあるため、ウェブでホストする機能を付けました。スタートアップとして`RunBatchEngineAsync`の代わりに`RunBatchEngineWebHosting`を使うだけです。

public class Program
{
 public static async Task Main(string[] args)
 {
 await new WebHostBuilder().RunBatchEngineWebHosting("http://localhost:12345");
 }
}

これはSwaggerによってホストされるため、実行確認等が容易になります。

MicroBatchFrameworkの.NET的な新しさ

.NET Generic Hostの上にコンソールアプリケーションを構築するというのが、MicroBatchFrameworkの新しさです。

.NET Generic Hostは、標準的な仕組みとしてロギング/コンフィグ読み込み/DIをサポートしています。これによりコンフィグのマッピング、ロギングなどを標準的な作法でフルサポートしています。

// appconfig.json
{
 "Foo": 42,
 "Bar": true
}
class Program
{
 static async Task Main(string[] args)
 {
 await BatchHost.CreateDefaultBuilder()
 .ConfigureServices((hostContext, services) =>
 {
 // mapping config json to IOption<MyConfig>
 services.Configure<MyConfig>(hostContext.Configuration);
 })
 .RunBatchEngineAsync<MyFirstBatch>(args);
 }
}
public class MyFirstBatch : BatchBase
{
 IOptions<MyConfig> config;
 ILogger<MyFirstBatch> logger;
 // get configuration from DI.
 public MyFirstBatch(IOptions<MyConfig> config, ILogger<MyFirstBatch> logger)
 {
 this.config = config;
 this.logger = logger;
 }
 public void ShowOption()
 {
 logger.LogInformation(config.Value.Bar);
 logger.LogInformation(config.Value.Foo);
 }
}

これをやっているフレームワークって意外とないのです(なぜなら.NET Generic Host自体が最近出来た仕組みなので)。この辺りもまた「現状のC#に欠けているものを埋めていく」ということです。

まとめ

C#でも存外CLIツールを書きやすいな、と思ってもらえるとうれしいですね! ちゃんと全プラットフォームで動くので、C#でCLI書くのは大いにアリです。そしてまた、C#でも特別なことはなくCircleCIやDockerなどの普通のエコシステムに乗れているということが伝わるとなおうれしいです。

個人的には、サーバーレス(FaaS)は縛りがキツすぎて自由なアプリケーション開発にならないためあまり好きではありません。インフラを気にしたくないのは事実ですが、余計なSDK、ローカル開発におけるエミュレーターやランタイムによる起動の遅さなど、デメリットが多いと感じています。

理想は、シンプルなコンソールアプリケーションで書いてコンテナ化して、それがインフラを気にせず動いてくれるということであり、そしてその中で私がアプリケーション開発者として何よりも優先したいのが「シンプルなコンソールアプリケーション」であること。インフラ面ではAWS Batchのようなフルマネージドなものから、ちょっと学習も必要ですがマネージドKubernetesが主要クラウドサービスでは使えることもあり、理想的なイメージに近づいてきている印象があります。

FaaSに関しては、FaaSだからこそシンプルに実現できること以上のことはやりたくないし、そうじゃないやり方のために MicroBatchFrameworkが助けになれればと思っていますので、ぜひお試しください!

また、Cy#では、こうした次世代のC#の研究を「.NET Core」と「Unity」を主軸に行っています。ご興味のある方は、まずは私宛てにお問い合わせください。


© Cygames, Inc.
quot;Hello My Batch from {name}"); } } }

これは `SampleApp.exe -name “foo” -repeat 5` で呼び出すことが可能、という仕様です。

// 引数に別名や説明をつけたり
public void Hello(
 [Option("n", "name of send user.")]string name,
 [Option("r", "repeat count.")]int repeat = 3)
{
 // ...omit
}
// サブコマンドの作成や、引数順番でもバインディングなどをサポート
[Command("escape")]
public void UrlEscape([Option(0)]string input)
{
 Console.WriteLine(Uri.EscapeDataString(input));
}

煩わしい定型的な引数の解析に悩まされることなく 【エムズスピード M'z SPEED】[HARRIER]ラヴライン マフラー左右4本出し (MZ56-2) 2500/HV、メソッドだけ定義すれば、あとはすべてよしなにやってくれます。

.NET Coreで作成したアプリは、ランタイムのインストールも不要な実行ファイルを Windows/Linux/Mac向けに作ることができます。また、CIに関してもCircleCIのようなコンテナベースのCIを、他の言語と遜色なく利用することが可能です。例えば以下のような記述で、実行ファイル生成をCIに任せられます。

version: 2.1
executors:
 dotnet:
 docker:
 - image: mcr.microsoft.com/dotnet/core/sdk:2.2
 environment:
 DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
 NUGET_XMLDOC_MODE: skip
jobs:
 publish-all:
 executor: dotnet
 steps:
 - checkout
 - run: dotnet publish -c Release --self-contained -r win-x64 -o ./MicroBatchSample/win-x64
 - run: dotnet publish -c Release --self-contained -r linux-x64 -o ./MicroBatchSample/linux-x64
 - run: dotnet publish -c Release --self-contained -r osx-x64 -o ./MicroBatchSample/osx-x64
 - run: apt update && apt install zip -y
 - run: zip -r MicroBatchSample.zip ./MicroBatchSample
 - store_artifacts:
 path: MicroBatchSample.zip
 destination: MicroBatchSample.zip
workflows:
 version: 2
 publish:
 jobs:
 - publish-all

この辺りは、もはやC#だからといってWindowsに縛られたり、使えるシステムに制約があったりということはなく、自由に組み合わせていくことができる証左と言えるでしょう。

また、配布に関しては.NET CoreグローバルツールというNPM Global Toolsのような仕組みも用意されています。例えば以下のようなUlid生成のためのツールをMicroBatchFrameworkと.NET Coreグローバルツールで作ってみました。

これにより、dotnetコマンドが使える環境に対するCLIツールの配布、管理が容易になっています。

バッチのためのフレームワーク

MB5 フロント左右セット DIXCEL 3312759 コンチェルト/ドマーニ コンチェルト/ドマーニ ブレーキローター フロント左右セット ブレーキディスク【店頭受取対応商品】 PD(プレーンディスク) ディクセル ディスクローター

C#とバッチはけっこう相性が良いと思っています。その最たるところは並列処理で、とりあえず実行時間かかりそうなものはParallelにするだけで、バッチ突き抜け率を大幅に低減することができます。

// これを
foreach(var item in foo)
{
// なんかたくさん処理する
}
// こうするだけ
Parallel.ForEach(item =>
{
// なんか色々やる
});

というのはともかく 【ムゲン】アコード ACCORD 【 06年10月-08年12月 】 フロントスポーツグリル ACCROD FRONT SPORTS GRILLE 《適合: CL7-130 CL7-330 CL8-130 CL9-130 》、実際にプロダクトで使うバッチ処理は複数、むしろ山のように用意することがほとんどだと思います。それらを単一のコンソールアプリケーションで効率よく管理できるように、クラスとメソッドを定義するだけで出し分けられるシステムを用意しました。

class Program
{
 static async Task Main(string[] args)
 {
 // <T>を渡さないと複数検索モードになる
 await BatchHost.CreateDefaultBuilder().RunBatchEngineAsync(args);
 }
}
// こんなクラスや
public class Foo : BatchBase
{
 // こんなメソッドや
 public void Echo(string msg)
 {
 this.Context.Logger.LogInformation(msg);
 }
 // こんなメソッドを
 public void Sum(int x, int y)
 {
 this.Context.Logger.LogInformation(

MicroBatchFramework – クラウドネイティブ時代のC#バッチフレームワーク

Posted on

Cy#の河合です。昨年12月に、『MagicOnion』というライブラリのリリースを告知しました。今回、再びオープンソースライブラリとして、C#のためのCLI/Batchライブラリをリリースしました。

[GitHub – Cysharp/MicroBatchFramework]

.NET CoreになってWindows/Mac/Linux問わずクロスプラットフォームなアプリケーション開発環境として機能するようになったC#ですが、そして機能的には十分揃っているのですが、ちょっと気の利いたフレームワークは意外と欠けているところがあります。バッチ・コマンドラインアプリ。というと地味なトピックスですが、ゆえに基本機能以上のサポートがなかったりします。しかし、「C#の可能性を切り開いていく」という理念を掲げるCy#としては、派手・地味を問わず、現状のC#に欠けているものを埋めていくことで、C#がアプリケーションを作る環境として、より良いものなるようにしたいと思っています。

CLIツールのためのフレームワーク

すでにC#にはコマンドライン引数の解析ツールはたくさんあります。とはいえ、そもそもそういうツールを使う時は「コマンドライン引数の解析」がしたいわけではなくて、「パラメータバインディング」をしたいのが一般的と思われます。ということで、『MicroBatchFramework』はウェブフレームワークのようにメソッドを呼び出してくれる仕様にしました。

class Program
{
 static async Task Main(string[] args)
 {
 // エントリポイント。この1行でフレームワークのStartup設定は終わりです。
 await BatchHost.CreateDefaultBuilder().RunBatchEngineAsync<MyFirstBatch>(args);
 }
}
// 実際のバッチの定義
public class MyFirstBatch : BatchBase // BatchBaseを継承してもらって
{
 // void(同期)かTask(非同期)の戻り値が設定可能、パラメータはどんな型も自由(JSONからマッピングします)
 public void Hello(string name, int repeat = 3)
 { 
 for (int i = 0; i < repeat; i++)
 {
 this.Context.Logger.LogInformation($"Hello My Batch from {name}");
 }
 }
}

これは `SampleApp.exe -name “foo” -repeat 5` で呼び出すことが可能、という仕様です。

// 引数に別名や説明をつけたり
public void Hello(
 [Option("n", "name of send user.")]string name,
 [Option("r", "repeat count.")]int repeat = 3)
{
 // ...omit
}
// サブコマンドの作成や、引数順番でもバインディングなどをサポート
[Command("escape")]
public void UrlEscape([Option(0)]string input)
{
 Console.WriteLine(Uri.EscapeDataString(input));
}

煩わしい定型的な引数の解析に悩まされることなく、メソッドだけ定義すれば、あとはすべてよしなにやってくれます。

.NET Coreで作成したアプリは、ランタイムのインストールも不要な実行ファイルを Windows/Linux/Mac向けに作ることができます。また、CIに関してもCircleCIのようなコンテナベースのCIを、他の言語と遜色なく利用することが可能です。例えば以下のような記述で、実行ファイル生成をCIに任せられます。

version: 2.1
executors:
 dotnet:
 docker:
 - image: mcr.microsoft.com/dotnet/core/sdk:2.2
 environment:
 DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
 NUGET_XMLDOC_MODE: skip
jobs:
 publish-all:
 executor: dotnet
 steps:
 - checkout
 - run: dotnet publish -c Release --self-contained -r win-x64 -o ./MicroBatchSample/win-x64
 - run: dotnet publish -c Release --self-contained -r linux-x64 -o ./MicroBatchSample/linux-x64
 - run: dotnet publish -c Release --self-contained -r osx-x64 -o ./MicroBatchSample/osx-x64
 - run: apt update && apt install zip -y
 - run: zip -r MicroBatchSample.zip ./MicroBatchSample
 - store_artifacts:
 path: MicroBatchSample.zip
 destination: MicroBatchSample.zip
workflows:
 version: 2
 publish:
 jobs:
 - publish-all

この辺りは、もはやC#だからといってWindowsに縛られたり、使えるシステムに制約があったりということはなく、自由に組み合わせていくことができる証左と言えるでしょう。

また、配布に関しては.NET CoreグローバルツールというNPM Global Toolsのような仕組みも用意されています。例えば以下のようなUlid生成のためのツールをMicroBatchFrameworkと.NET Coreグローバルツールで作ってみました。

これにより、dotnetコマンドが使える環境に対するCLIツールの配布、管理が容易になっています。

バッチのためのフレームワーク

C#とバッチはけっこう相性が良いと思っています。その最たるところは並列処理で、とりあえず実行時間かかりそうなものはParallelにするだけで、バッチ突き抜け率を大幅に低減することができます。

// これを
foreach(var item in foo)
{
// なんかたくさん処理する
}
// こうするだけ
Parallel.ForEach(item =>
{
// なんか色々やる
});

というのはともかく、実際にプロダクトで使うバッチ処理は複数、むしろ山のように用意することがほとんどだと思います。それらを単一のコンソールアプリケーションで効率よく管理できるように、クラスとメソッドを定義するだけで出し分けられるシステムを用意しました。

class Program
{
 static async Task Main(string[] args)
 {
 // <T>を渡さないと複数検索モードになる
 await BatchHost.CreateDefaultBuilder().RunBatchEngineAsync(args);
 }
}
// こんなクラスや
public class Foo : BatchBase
{
 // こんなメソッドや
 public void Echo(string msg)
 {
 this.Context.Logger.LogInformation(msg);
 }
 // こんなメソッドを
 public void Sum(int x, int y)
 {
 this.Context.Logger.LogInformation($"{x + y}"); 
 }
}
// こんなクラスを
public class Bar : BatchBase
{
 public void Hello2()
 {
 this.Context.Logger.LogInformation("H E L L O");
 }
}

このように、第1引数によって実行するメソッドを切り替えられます。

SampleApp.exe Foo.Echo -msg "aaaaa"
SampleApp.exe Foo.Sum -x 100 -y 200
SampleApp.exe Bar.Hello2

さて、こうして出来たアプリケーションは、コンテナ化するのをお薦めします。.NET CoreならばC#でもコンテナ化は簡単です。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS sdk
WORKDIR /workspace
COPY . .
RUN dotnet publish ./MicroBatchFrameworkSample.csproj -c Release -o /app
FROM mcr.microsoft.com/dotnet/core/runtime:2.2
COPY --from=sdk /app .
ENTRYPOINT ["dotnet", "MicroBatchFrameworkSample.dll"]

例えばこれをAWS ECRにCircleCIで上げるなら、以下のようなコンフィグになるでしょう。

version: 2.1
orbs:
 aws-ecr: circleci/aws-ecr@3.1.0
workflows:
 build-push:
 jobs:
 # see: https://circleci.com/orbs/registry/orb/circleci/aws-ecr
 - aws-ecr/build_and_push_image:
 repo: "microbatchsample"

非常にシンプルに書けるし、C#だからといって特別なことはなく、一般的なエコシステムに乗っているわけです。

こうして上がったコンテナは、あとはただのコンテナなので好きなように実行すればいいわけですが、例えばAWS Batchを使えば比較的シンプルに実行もスケジューリング(CloudWatchでイベントトリガを設定可能)も定義可能です。そして、ログはCloudWatchで標準出力が確認できます。

複雑なワークフローを定義したい場合は、別途LuigiApache Airflowが使えるはずです。

Swaggerによるウェブインターフェイス

開発時など、いちいちコマンド打って確認するのも面倒な場合もあるため、ウェブでホストする機能を付けました。スタートアップとして`RunBatchEngineAsync`の代わりに`RunBatchEngineWebHosting`を使うだけです。

public class Program
{
 public static async Task Main(string[] args)
 {
 await new WebHostBuilder().RunBatchEngineWebHosting("http://localhost:12345");
 }
}

これはSwaggerによってホストされるため、実行確認等が容易になります。

MicroBatchFrameworkの.NET的な新しさ

.NET Generic Hostの上にコンソールアプリケーションを構築するというのが、MicroBatchFrameworkの新しさです。

.NET Generic Hostは、標準的な仕組みとしてロギング/コンフィグ読み込み/DIをサポートしています。これによりコンフィグのマッピング、ロギングなどを標準的な作法でフルサポートしています。

// appconfig.json
{
 "Foo": 42,
 "Bar": true
}
class Program
{
 static async Task Main(string[] args)
 {
 await BatchHost.CreateDefaultBuilder()
 .ConfigureServices((hostContext, services) =>
 {
 // mapping config json to IOption<MyConfig>
 services.Configure<MyConfig>(hostContext.Configuration);
 })
 .RunBatchEngineAsync<MyFirstBatch>(args);
 }
}
public class MyFirstBatch : BatchBase
{
 IOptions<MyConfig> config;
 ILogger<MyFirstBatch> logger;
 // get configuration from DI.
 public MyFirstBatch(IOptions<MyConfig> config, ILogger<MyFirstBatch> logger)
 {
 this.config = config;
 this.logger = logger;
 }
 public void ShowOption()
 {
 logger.LogInformation(config.Value.Bar);
 logger.LogInformation(config.Value.Foo);
 }
}

これをやっているフレームワークって意外とないのです(なぜなら.NET Generic Host自体が最近出来た仕組みなので)。この辺りもまた「現状のC#に欠けているものを埋めていく」ということです。

まとめ

C#でも存外CLIツールを書きやすいな、と思ってもらえるとうれしいですね! ちゃんと全プラットフォームで動くので、C#でCLI書くのは大いにアリです。そしてまた、C#でも特別なことはなくCircleCIやDockerなどの普通のエコシステムに乗れているということが伝わるとなおうれしいです。

個人的には、サーバーレス(FaaS)は縛りがキツすぎて自由なアプリケーション開発にならないためあまり好きではありません。インフラを気にしたくないのは事実ですが、余計なSDK、ローカル開発におけるエミュレーターやランタイムによる起動の遅さなど、デメリットが多いと感じています。

理想は、シンプルなコンソールアプリケーションで書いてコンテナ化して、それがインフラを気にせず動いてくれるということであり、そしてその中で私がアプリケーション開発者として何よりも優先したいのが「シンプルなコンソールアプリケーション」であること。インフラ面ではAWS Batchのようなフルマネージドなものから、ちょっと学習も必要ですがマネージドKubernetesが主要クラウドサービスでは使えることもあり、理想的なイメージに近づいてきている印象があります。

FaaSに関しては、FaaSだからこそシンプルに実現できること以上のことはやりたくないし、そうじゃないやり方のために MicroBatchFrameworkが助けになれればと思っていますので、ぜひお試しください!

また、Cy#では、こうした次世代のC#の研究を「.NET Core」と「Unity」を主軸に行っています。ご興味のある方は、まずは私宛てにお問い合わせください。


© Cygames, Inc.
quot;{x + y}"); } } // こんなクラスを public class Bar : BatchBase { public void Hello2() { this.Context.Logger.LogInformation("H E L L O"); } }

このように 【イベント開催中!】 SUNSTAR サンスター フロント・リアスプロケット&チェーン・カシメジョイントセット チェーン銘柄:DID製STD525VX(スチールチェーン) STREET TRIPLE STREET TRIPLE R、第1引数によって実行するメソッドを切り替えられます。

SampleApp.exe Foo.Echo -msg "aaaaa"
SampleApp.exe Foo.Sum -x 100 -y 200
SampleApp.exe Bar.Hello2

さて、こうして出来たアプリケーションは、コンテナ化するのをお薦めします。.NET CoreならばC#でもコンテナ化は簡単です。

FROM mcr.microsoft.com/dotnet/core/sdk:2.2 AS sdk
WORKDIR /workspace
COPY . .
RUN dotnet publish ./MicroBatchFrameworkSample.csproj -c Release -o /app
FROM mcr.microsoft.com/dotnet/core/runtime:2.2
COPY --from=sdk /app .
ENTRYPOINT ["dotnet", "MicroBatchFrameworkSample.dll"]

例えばこれをAWS ECRにCircleCIで上げるなら、以下のようなコンフィグになるでしょう。

version: 2.1
orbs:
 aws-ecr: circleci/aws-ecr@3.1.0
workflows:
 build-push:
 jobs:
 # see: https://circleci.com/orbs/registry/orb/circleci/aws-ecr
 - aws-ecr/build_and_push_image:
 repo: "microbatchsample"

非常にシンプルに書けるし、C#だからといって特別なことはなく ツバキ チェーン Tsubaki Chain kit KAWASAKI ER5 (520 types ALPHA ORS)【ヨーロッパ直輸入品】 16 45 ER5 (500) 97-06、一般的なエコシステムに乗っているわけです。

こうして上がったコンテナは、あとはただのコンテナなので好きなように実行すればいいわけですが、例えばAWS Batchを使えば比較的シンプルに実行もスケジューリング(CloudWatchでイベントトリガを設定可能)も定義可能です。そして、ログはCloudWatchで標準出力が確認できます。

複雑なワークフローを定義したい場合は、別途 14インチ サマータイヤ セット【適応車種:ゼスト スパーク(JE系 NA車 2WD)】HOT STUFF ララパーム カップ プラチナシルバー/リムポリッシュ 4.5Jx14トランパス LUK 165/55R14 [Azur アズール] ハンドルカバー いすず(ISUZU) 4t フォワード320/342(H6.2~H19.6) エナメルホワイト 2HLサイズ(外径約47~48cm) XS54I24A-2HL-002LuigiApache Airflowが使えるはずです。

Swaggerによるウェブインターフェイス

開発時など 【メーカー在庫あり】 スウェッジライン SWAGE-LINE フロント ブレーキホースキット 87年-95年 エリミネーター250 黒 スモーク BAFB620 HD店、いちいちコマンド打って確認するのも面倒な場合もあるため、ウェブでホストする機能を付けました。スタートアップとして`RunBatchEngineAsync`の代わりに`RunBatchEngineWebHosting`を使うだけです。

public class Program
{
 public static async Task Main(string[] args)
 {
 await new WebHostBuilder().RunBatchEngineWebHosting("http://localhost:12345");
 }
}

これはSwaggerによってホストされるため、実行確認等が容易になります。

MicroBatchFrameworkの.NET的な新しさ

.NET Generic Hostの上にコンソールアプリケーションを構築するというのが、MicroBatchFrameworkの新しさです。

.NET Generic Hostは、標準的な仕組みとしてロギング/コンフィグ読み込み/DIをサポートしています。これによりコンフィグのマッピング、ロギングなどを標準的な作法でフルサポートしています。

// appconfig.json
{
 "Foo": 42,
 "Bar": true
}
class Program
{
 static async Task Main(string[] args)
 {
 await BatchHost.CreateDefaultBuilder()
 .ConfigureServices((hostContext, services) =>
 {
 // mapping config json to IOption<MyConfig>
 services.Configure<MyConfig>(hostContext.Configuration);
 })
 .RunBatchEngineAsync<MyFirstBatch>(args);
 }
}
public class MyFirstBatch : BatchBase
{
 IOptions<MyConfig> config;
 ILogger<MyFirstBatch> logger;
 // get configuration from DI.
 public MyFirstBatch(IOptions<MyConfig> config, ILogger<MyFirstBatch> logger)
 {
 this.config = config;
 this.logger = logger;
 }
 public void ShowOption()
 {
 logger.LogInformation(config.Value.Bar);
 logger.LogInformation(config.Value.Foo);
 }
}

これをやっているフレームワークって意外とないのです(なぜなら.NET Generic Host自体が最近出来た仕組みなので)。この辺りもまた「現状のC#に欠けているものを埋めていく」ということです。

まとめ

C#でも存外CLIツールを書きやすいな、と思ってもらえるとうれしいですね! ちゃんと全プラットフォームで動くので、C#でCLI書くのは大いにアリです。そしてまた、C#でも特別なことはなくCircleCIやDockerなどの普通のエコシステムに乗れているということが伝わるとなおうれしいです。

個人的には、サーバーレス(FaaS)は縛りがキツすぎて自由なアプリケーション開発にならないためあまり好きではありません。インフラを気にしたくないのは事実ですが、余計なSDK、ローカル開発におけるエミュレーターやランタイムによる起動の遅さなど、デメリットが多いと感じています。

理想は、シンプルなコンソールアプリケーションで書いてコンテナ化して、それがインフラを気にせず動いてくれるということであり、そしてその中で私がアプリケーション開発者として何よりも優先したいのが「シンプルなコンソールアプリケーション」であること。インフラ面ではAWS Batchのようなフルマネージドなものから、ちょっと学習も必要ですがマネージドKubernetesが主要クラウドサービスでは使えることもあり、理想的なイメージに近づいてきている印象があります。

FaaSに関しては、FaaSだからこそシンプルに実現できること以上のことはやりたくないし、そうじゃないやり方のために MicroBatchFrameworkが助けになれればと思っていますので、ぜひお試しください!

また、Cy#では、こうした次世代のC#の研究を「.NET Core」と「Unity」を主軸に行っています。ご興味のある方は、

ディクセル ブレーキローター PD(プレーンディスク) フロント左右セット コンチェルト/ドマーニ MB5 3312759 DIXCEL ディスクローター ブレーキディスク【店頭受取対応商品】

、まずは私宛てにお問い合わせください。


{yahoojp} {tech.cygames.co.jp}
{yahoojp}jpprem01-zenjp40-wl-zd-29286
{yahoojp}jpprem01-zenjp40-wl-zd-29286
{yahoojp}jpprem01-zenjp40-wl-zd-29286