# MirageDebug

MirageDebug：用于 Kubernetes 应用的本地远程调试工具，实现完全真实环境的调试。

![MirageDebug](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/community/images/flow.d2.svg)

## 安装

### 安装 miragedebug

目前，安装 MirageDebug 需要 GO 运行环境，并可以使用以下方法进行安装：

```bash
go install github.com/miragedebug/miragedebug/cmd/mirage-debug@latest
```

## 使用方法

### MirageDebug 服务器 - 后台服务

MirageDebug 服务器是一个后台服务，用于管理调试会话并提供有关调试会话的相关信息。

#### 启动 MirageDebug 服务器

```bash
mirage-debug server
```

### 初始化调试应用程序

在项目根目录中执行以下命令，初始化调试应用程序，并按提示填写相关信息。

```bash
mirage-debug init
```

### 编写 IDE 配置文件

MirageDebug 可以自动生成不同 IDE 的调试配置文件，使本地调试变得简单。

```bash
mirage-debug config <APPNAME>
```

### 开始调试

一旦配置好 IDE，就可以直接在 IDE 中开始调试了。

## 演示

### 在 Kubernetes 集群中使用 VSCode 调试 Rust 应用程序

[![在 K8s 中使用 MirageDebug 调试 Rust 应用：使用 VSCode 从本地调试 ztunnel](https://img.youtube.com/vi/RpggulEd48M/0.jpg)](https://www.youtube.com/watch?v=RpggulEd48M)

### 在 Kubernetes 集群中使用 Goland 调试 istiod

[![MirageDebug：从本地集群中使用 Goland 调试 Istio（引导发现）](https://img.youtube.com/vi/ZwG0uaG72_8/0.jpg)](https://www.youtube.com/watch?v=ZwG0uaG72_8)