架构

基于 MASA 的云原生技术架构

我们基于 MASA 去做了一个云原生技术架构，左下角的 MASA Blazor 主要是为我们去集成一个多端的 UI 能力，具体的使用场景将在实践篇为大家介绍——MASA Blazor 如何去做多端的

接着就是集成非业务能力的 MASA Framework，它主要是解决整个云原生架构中非业务性的问题

在这两个基础上，我们就可以去编写业务代码，业务代码完成后上传 GitHub 并发布到微服务的集群里面，而 MASA Stack 则是提供的平台管理能力

最右边的第三方系统管理是最关键的一部分，我们第三方系统调用是通过 Dapr 来管理，不难看到 MASA Framework 和 Dapr 有部分重叠，MASA Framework 对 Dapr 进行二次封装，既可以让大家体验类似.Net 原生操作，又可以作为适配层对 Dapr 进行替换

MASA Stack 平台架构

研发协作平台：更多的是去帮助大家解决在研发过程当中的一些协作类的问题

现代化应用治理平台：主要是帮助大家解决在应用层面的一些治理问题

可观测性平台：解决的是一些可观测问题，在平台工程里面，帮助大家去采集一些公共的日志、跟踪、指标、数据等等

数据开发平台：在 MASA Stack 平台里是非常重要的一个环节，在 1.0 和 2.0 中的工作主要是作为 3.0 的基建，为 3.0 做铺垫

低代码开发平台：解决 API 侧的编排问题，更多的还是偏开发，针对 IT 开发者，并不傻瓜化

集成平台：解决系统集成间的一些问题

MASA Stack 功能架构

MASA Stack 的功能架构底部的内容已经在前面介绍过，那我们来看下上面的内容

第一部分是研发管理部分，紧接着是现代化应用开发治理，这里面可以看到比如 API 网关、应用治理这些功能。第三部分数据开发与治理，是数据开发相关的内容。最后一个是可观测性，从功能结构上来说，MASA Stack1.0 是其中的基础部分，但未来的 3.0 我们还会继续往里面补充内容，追加新的功能，并不局限于这四个版块

设计理念

能力：单体/分布式皆可

配置：可配置但约定优于配置

开放：可二开，可对接，也可以任意替换

标准：面向 API 和 SDK 编程

组合：通过对能力的组合，形成专属平台

应用现代化

平台工程

01 价值

为了帮助开发人员、数据科学家和终端用户，并减少他们从事有价值工作的阻力，平台工程优化了开发者体验并加速数字交付

02 如何优化开发者体验

提供一套精心策划的工具、功能和流程。减少开发者的认知负担，并包含开发团队需要的一切，以最适合他们的工作流程呈现

支持的业务策略：创建安全的底座、加速数字化、吸引和留住人才

03 关键

先构建内部开发者门户，这是最成熟、最容易理解的平台类型。积累的经验可以扩展到其他平台，平台必须将安全性嵌入到工作流程。全面、自动化的安全性和合规性检查作为测试套件的一部分，不要指望商业的一站式解决方案，无论如何你都需要定制它

MASA Stack 全景

MASA Stack 全景主要分为两大部分，MASA Stack 每个版本是如何融合在一起的，它们之间的关系是什么？在这张图里都有清楚的展示

图中左边这一部分更贴近现代化应用部分，右边则是可观测性部分，在 MASA Stack 1.0 我们做的更多是一些基建类的东西，为后续版本打基础

2.0 是图上白色部分，例如左下角的 Workflow；3.0 是图上不明显的灰色部分，比如左下角的 Function，这些都是正在搭建的功能，会随着版本更新逐步实现

MASA Blazor

MASA Blazor 适用于 PC 端和移动端，包含两个库，第一个就是 Blazor Component，主要提供了一个不包含样式的纯交互的组件库，第二个 MASA Blazor 是基于 Vuetify 一个 Material Design 的组件库

MASA Framework

Building Blocks >>接口 &能力>>提供非业务能力的接口，并提供组合多个能力形成新的能力的最佳实践

Contrib>>实现>>基于构建块的接口标准提供最佳实践，可被替换实现

Utils>>通用类库>>底层通用能力，可被用于业务和 Contrib

Templates>>模板>>用于创建项目

项目管理

MASA PM 是一款底层基建项目管理产品，提供 0-1 初始化的部分内容。从最初的底层环境创建，部署和创建对应的集群。编辑环境与集群的组合关系，在所需求的环境集群上创建项目。

权限中心

MASA Auth 是 MASA Stack 中最核心的功能之一，它统一负责了所有产品的权限、菜单、用户等。它包含了单点登录、用户管理、RBAC3、第三方平台接入、Ldap 等企业级功能。除了可以用在企业内部管理系统，它还可以帮助管理 C 端用户。

配置中心

MASA DCC 是 MASA Stack1.0 推出的分布式配置中心，在整个 MASA Stack 产品中担任所有系统以及部分全局综合配置的功能。

消息中心

MASA Stack 1.0 系统合集中底层支持消息发送的一款综合性产品，担任了全局消息系统支持多渠道的配置与消息发送规则的配置，并且可以配置多种消息模板以及特定用户组群。可以与关联产品 Alert、TSC 等对接，一站式解决故障问题触发与处理。

调度中心

Scheduler 是 MASA Stack 1.0 推出的一款辅助性软件产品，主要负责处理应用程序任务执行的调度，以及自动重试等相关操作。在 MASA Stack 产品中，与 MASA MC、MASA TSC、MASA Alert 3 款产品结合，发挥最大的调度价值。当然 Scheduler 并不只是给 MASA Stack 产品使用，它同样可以为业务创造价值。

故障排查控制台

MASA TSC 主要负责对 MASA 整个系统中的项目/应用进行监测来排查故障情况，其中包含从项目维度视角来查看监测的故障情况。以及溯源到具体的链路日志中去。除了可以监控整个 MASA Stack 的产品外，与 PM 进行组合使用，也可以将业务系统接入进来统一管理。

告警中心

MASA Alert 是一款配合性产品，主要提供告警规则以及制定相关指标。它需要借助几个产品的基础功能组合来发挥它的价值，比如故障排查控制台作为监测数据源，调度中心作为调度周期控制，消息中心作为发送消息的渠道。MASA Stack 会尽可能的复用基础功能，而不是重复性工作，所以单一部署它将失去意义，产品结合可以发挥告警中心的最大价值。

文档中心

MASA Stack 1.0 的文档将统一放在文档中心里，目前是比较早期的文档内容，我们会在 1.0 前继续完善它

优势

成本低：统一技术栈、统一交互、免费

不卡脖子：技术自主可控、云原生、开源

一站式：网页端、桌面端、微服务、云、移动端、IoT、ML、游戏

集成强：平台无边界、不限制开发语言、提供 API 和 SDK

体系完善：应用交付、数据治理、安全智能、领域最佳实践

如何开始

安装 MASA Stack - Helm

介绍了那么多，那我们如何开始使用 MASA Stack 呢？

这里我们分为两部分进行讲解，第一部分是 MASA Stack 的安装和接入

安装 MASA Stack 我们提供了 Helm，首先需要准备 K8s 集群，有了集群后就可以创建 namespace（这一步是可选项，也可以选择不创建），然后创建一个 strong class（部署环境要求），部署 Dapr 搭建环境，使用 MASA Stack Helm 安装

代码也是比较简单的

helm repo add masastack https://github.com/masastack/helmhelm repo updatehelm search repo masastack --devel --versionshelm upgrade --install  masastack masastack/masastack --version=xxx --namespace masastack --create-namespace --wait

虽然安装步骤简单，但实际上对 K8s 是要一些技术要求的，如果对 K8s 不是很熟悉的话，门槛相对来说还是比较的高的，之后我们也会录制 MASA Stack 相关的安装教程视频给大家

接入 MASA Stack

如果你是.NET 用户，我们提供了 SDK，直接接入即可

如果你是其他语言用户，我们现阶段是没有 SDK 的，可以通过标准的 API 去对接

异构

如果你的项目是一个异构的，里面有不同的语言那怎么办呢？

其实可以通过 Dapr 的方式去做，如果它提供了 SDK，可以根据的原有的 SDK 去调整。如果没有，可以按照图上这个标准接口去实现对接

Windows 本地开发环境

接下来是基于 MASA Framework 的开发，首先在我们的 Windows 本地开发环境里面，绝大数步骤都是可选的，但如果你用的是 Dapr，还是希望可以选择完整的流程去开发项目

安装 WSL→安装 Docker→安装 Dapr，这里都是为了安装 Dapr 做准备

准备工作完成后就是创建项目，这一步可以使用我们的模板或者从零开始都没有问题，然后需要添加 Masa.Contrib.Development.DaprStarter.AspNetCore 包，

最后一步就是在 Program.cs 添加代码

#if DEBUGbuilder.Services.AddDaprStarter();#endif

它可以帮你去管理 Dapr 的一个生命周期

基于模板创建新项目

基于模板创建新项目这一部分需要先安装 MASA 模板

dotnet new install Masa.Template

然后使用 MASA Framework Project 模板去创建项目，这过程中会有一些引导，去引导你去选择哪些选项（右图所示），按需勾选即可，这个阶段就是我们在自定义我们整个项目的结构，最后点击创建即完成

老项目对接

如果是老项目对接怎么办？这里有四种方式可选

用的比较多的是 HTTP，可以用 MASA Framework Caller 或者 HttpClient 去对接

第二个是 gRPC，这里需要注意的是，MASA Framework Caller （2.0）才能实现对 gRPC 的支持，现阶段使用的比较多的 Grpc.Net.Client

最后一个就是 Dapr，我们的 Caller 提供了 Dapr 的全集合

这三种方式里 Caller 都出现了，如果说你的项目比较复杂，可能用了不同的协议，还是更推荐 Caller，因为 Caller 是我们的一个构建块，它是面对接口的方式去编程的，不管你对接哪一种方式，只需要调换 Contrib 包，书写方式没有特别大的区别

以上三种方式是大家比较常见的，最后一种方式是还在开发中的 MASA Stack 2.0 集成平台，在 2.0 里，我们会做一个集成平台，它会帮大家去接管内外的应用，HTTP、gRPC、Dapr 在我们的集成平台里面都可以快速接进来

扫码观看回放

如果你对我们的开源项目感兴趣，无论是代码贡献、使用、提 Issue，欢迎联系我们

• WeChat：MasaStackTechOps

• QQ：7424099