这个展示库包括一个示例音乐应用程序和其他清单，以展示 SkyWalking 的主要功能。音乐应用程序由几个用不同编程语言编写的微服务组成。这是架构：
用法
展示使用GNU Make和 Docker 容器来运行命令，因此请确保您已make安装并运行 Docker 守护程序。
前提条件
要部署此展示应用程序的全部功能，您可能需要最多 4 个 CPU 内核和 4 GB 内存，如果您发现容器/Pod 无法启动，请增加 Docker 守护进程资源或 Kubernetes 集群资源。或者，如果您不想增加资源，也可以只部署您感兴趣的部分功能，通过定制指南。
快速开始
确保您有一个正在运行的 Kubernetes 集群并且kubectl可以访问该集群。
git clone https://github.com/apache/skywalking-showcase.git
cd skywalking-showcase
make deploy.kubernetes
这将安装 SkyWalking 组件，包括具有 2 个节点的集群模式 OAP、SkyWalking RocketBot UI、具有 SkyWalking 代理的微服务、没有 SkyWalking 代理但由 Istio 管理的微服务、2 个 Pod 来模拟虚拟机并将指标导出到 SkyWalking，并启用 kubernetes 集群监控以及 SkyWalking 的自我观察性。
如需更高级的部署，请查看官方的自定义文档。
请注意，当在本地运行此展示（例如 KinD）时，图像会在 KinD 中下载，这可能需要 10 分钟以上（取决于本地网络）。make deploy.kubernetes如果某些超时错误中断进程，请重新运行。
定制
Makefile.in通过指定具有相同名称的环境变量，可以覆盖中定义的变量以自定义展示，例如：
export ES_VERSION=7.14.0
make <target>
或直接在make命令中指定，例如：make <target> ES_VERSION=7.14.0.
运行make help以获取更多信息。
特征
FEATURE_FLAGS该展示由一组带有功能标志的场景组成，您可以通过覆盖定义的变量来部署其中一些您感兴趣的场景，Makefile.in如Customization中所述，例如：
make deploy.kubernetes FEATURE_FLAGS=single-node,agent
不同平台（Kubernetes和Docker Compose）的功能标志不一定相同，因此请确保指定正确的功能标志。
目前，支持的功能有：
| 姓名 | 描述 | 笔记 |
|---|---|---|
java-agent-injector |
使用 java 代理注入器注入 Skywalking Java 代理并在启用其他 SkyWalking 代理的情况下部署微服务。 | 微服务包括 Java、NodeJS 服务器、浏览器、Python 的代理。 |
cluster |
以集群方式部署 SkyWalking OAP，2 个节点，SkyWalking RocketBot UI，ElasticSearch 作为存储。 | 只能启用cluster或之一。single-node
|
single-node |
只部署一个 SkyWalking OAP 单节点，以及 SkyWalking RocketBot UI、ElasticSearch 作为存储。 | 只能启用cluster或之一。single-node
|
so11y |
启用 SkyWalking 自我可观察性。 | 这默认为平台Docker Compose启用。 |
vm |
启动 2 个虚拟机并将其指标导出到 SkyWalking。 | “虚拟机”由 Docker 容器或 Pod 模仿。 |
als |
在未启用 SkyWalking 代理的情况下启动微服务，并配置 SkyWalking 以分析其访问日志中的拓扑和指标。 |
istioctl运行此功能需要命令。无代理微服务将在命名空间运行${NAMESPACE}-agentless
|
kubernetes-monitor |
部署 OpenTelemetry 并将 Kubernetes 监控指标导出到 SkyWalking 进行分析并在 UI 上显示。 | |
istiod-monitor |
部署 OpenTelemetry 并将 Istio 控制平面指标导出到 SkyWalking 进行分析并在 UI 上显示。 | |
event |
部署工具来触发事件，以及 SkyWalking Kubernetes 事件导出器将事件导出到 SkyWalking。 |
Kubernetes
要在 Kubernetes 中部署示例应用程序，请确保您有kubectl可用的命令，并且它可以成功连接到 Kubernetes 集群。
如果您没有正在运行的集群，您还可以利用KinD（Docker 中的 Kubernetes） 或minikube来创建集群。
运行kubectl get nodes以检查连接，然后再进行下一步。指示您kubectl无法连接到集群的典型错误消息是：
The connection to the server localhost:8080 was refused - did you specify the right host or port?
部署
# Deploy
make deploy.kubernetes
# Undeploy
make undeploy.kubernetes
# Redeploy
make redeploy.kubernetes # equivalent to make undeploy.kubernetes deploy.kubernetes
Docker Compose（构成）
部署
# Deploy
make deploy.docker
# Undeploy
make undeploy.docker
# Redeploy
make redeploy.docker # equivalent to make undeploy.docker deploy.docker