マイクロサービスの Azure コンポーネント図

束のもつれを解こうとしたことがあるサーボモーターワイヤー？そう、午後を過ごすのに最も楽しい方法ではありません。特に、マイクロサービスのネットワーク上ですべてがどのように接続されるかを計画しようとしている場合は特にそうです。めちゃくちゃになります。速い。そして、Azure コンポーネント図を理解して、それらのマイクロサービスがどこで始まり、どこで終わるのかを理解する必要があります。

私たちは皆、そこに行ったことがあるでしょう。ホワイトボードにスケッチしていると、次の瞬間には、他の人にとってはあまり意味のない抽象的なボックスや矢印が膝まで埋もれることになります。ロボットを作ったけど、どのロボットにラベルを付けるかを忘れたようなものですサーボ腕をコントロールします。混乱が始まり、チームは互いにすれ違って話し始めます。進歩は恐ろしく遅くなる。

しかし、全体像をはっきりと見ることができたらどうでしょうか?すべてのサービス、すべてのリンク、すべてのデータ フローが、適切に配線された回路基板のように配置されています。もう推測する必要はありません。もう交差信号はありません。

では、この複雑な混乱から、マイクロサービスのセットアップ用のクリーンで読みやすい Azure ダイアグラムを作成するにはどうすればよいでしょうか?

まずは問題、つまり現実を反映していない図から始めましょう。実際に動作しているものとはまったく似ていない美しいアーキテクチャ図を見たことがあるでしょうか?綺麗だけど駄目だよ。重要なのは、それらを生きた文書にすることです。シンプルに始めましょう。 1 つのコア サービスとその通信相手をマッピングします。ユーザー認証を処理していますか?支払いを処理していますか?モーションシーケンスを制御しますか?まずそれを釘付けにしてください。

次に、依存関係を追加します。を校正するようなものだと考えてください。サーボ- 1 つのパラメータを調整すると、動作範囲全体に影響します。決済サービスは、データベースに ping を送信するログ サービスを呼び出す場合があります。それらの線を描きます。接続の種類に応じて、異なる色やスタイルを使用します。 HTTP 呼び出し、メッセージ キュー、データベース ヒット - それらを視覚的に区別します。

なぜわざわざこんなことをするのでしょうか？明確にすることで時間を節約できるからです。そして時間も、そうですね、さらに大幅に節約されます。ダイアグラムがシステムを反映すると、新しいチーム メンバーのオンボーディングが容易になります。デバッグが高速化され、文字通り、障害がどこに波及するかを確認できます。混乱を管理できるものに変えます。

ここで、「これはすぐに時代遅れになってしまうのではないか?」と疑問に思うかもしれません。絶対に、放っておけば。秘訣は、静的なブループリントではなく、ダッシュボードのように扱うことです。随時更新してください。サービスのエンドポイントの小さな変更ですか?図を調整します。新しいギアボックス コントローラー モジュールを追加しましたか?モーターを取り付ける前にトルクスペックを確認するなど、習慣にしてください。

では、これらの図を実際に役立つものにするにはどうすればよいでしょうか?文書化だけではなく、コミュニケーションにも重点を置きましょう。優れた図はストーリーを伝えます。ユーザーのクリックからさまざまなサービスを介して、物理コンポーネントの移動に至るまで、リクエストがどのように伝わるかを示しています。おそらく、API ゲートウェイで開始され、注文プロセッサにホップし、コマンド サービスを介して倉庫ロボット アームをトリガーする可能性があります。それは人々が従うことができる物語です。

そして、これが私たちが学んだことです。シンプルさは常に複雑さに打ち勝ちます。あらゆる詳細を 1 ページに詰め込まないでください。分割してください。大きな部分を示す高レベルの概要を作成してから、複雑なサービスごとにドリルダウン図を作成します。これは、メインのアセンブリ マニュアルとサブアセンブリごとに別のシートがあるようなもので、はるかに理解しやすくなっています。

色、形、ラベルは一貫して使用してください。サービスの長方形、データベースの円柱、非同期メッセージの破線。伝説を残してください。基本的なことのように聞こえますが、これを省略している図の多さに驚くでしょう。一貫性が図を信頼できるものにします。

実践してみましょう。デジタル ホワイトボードから専用の作図ソフトウェアまで、使いやすいツールを入手してください。今、真実だとわかっていることから始めましょう。初日から完璧を目指さないでください。それをスケッチしてチームと共有し、「これは意味をなしますか? 自分がどこに当てはまるかわかりますか?」と尋ねます。

繰り返します。リファイン。図は個人のプロジェクトではなく、チームの成果物である必要があります。コメントを残し、変更を提案し、存続させてください。そうすることで関連性を維持できるのです。

結局何の見返りがあるのでしょうか？システムの説明に費やす会議が減りました。何かがダウンした場合のトラブルシューティングを迅速化します。ハードウェア チームとソフトウェア チームを連携させる共有メンタル モデル。これは、サービスをコーディングする人とサーボを取り付ける人の間のギャップを埋めるものであり、両者は同じマップを見ていることになります。

前回、本番環境の問題の診断に何時間もかかったときのことを思い出してください。サービス A がコンポーネント B にどのように接続されているかが分からないことが問題の一部でしたか?明確な図があれば、その時間を半分に短縮できます。それは単なる写真ではありません。それはトラブルシューティングツールです。

このアプローチを採用すると、プロジェクトが好転するのを私たちは見てきました。混乱は静まり返ります。議論が集中していきます。変更は視覚的に追跡されます。それは、複雑な機械アセンブリの適切な回路図がついに完成したようなもので、すべてがカチッと所定の位置にはまるだけです。

それで、試してみてください。ホワイトボードの汚いスケッチを生き生きとしたものに変えましょう。小さなことから始めて、常に最新の情報を更新し、チームの習慣にしてください。明確になるのは図だけではありません。それは、よりスムーズなワークフロー、より良いコラボレーション、そして最終的には頭痛の種を減らすことです。そして、それを望まない人がいるでしょうか？

2005年に設立され、キロパワーは、中国広東省東莞に本社を置く、コンパクトモーションユニットの専門メーカーです。モジュラードライブテクノロジーのイノベーションを活用し、キロパワー高性能モーター、精密減速機、マルチプロトコル制御システムを統合し、効率的でカスタマイズされたスマート ドライブ システム ソリューションを提供します。キロパワーは、スマート ホーム システム、自動エレクトロニクス、ロボティクス、精密農業、ドローン、産業オートメーションなどのさまざまな分野をカバーする製品で、世界中の 500 を超える企業クライアントにプロフェッショナルなドライブ システム ソリューションを提供してきました。