wasmCloud 应用部署管理器（wadm）启动与配置教程

1. 项目目录结构及介绍

wadm 项目是一个 Wasm-native Orchestrator，用于管理和扩展声明式的 wasmCloud 应用程序。以下是项目的目录结构及其介绍：

• ./charts/：包含用于 Kubernetes 集群的 Helm 图表。
• ./crates/：存放 Rust 编写的依赖库和模块。
• ./docs/：包含项目文档。
• ./images/：存放项目相关的图片资源。
• ./oam/：包含 Open Application Model（OAM）相关的定义和配置。
• ./src/：wadm 的主要源代码目录。
• ./static/：存放静态文件，如 CSS、JavaScript 等。
• ./tests/：包含项目的测试用例。
• ./wit/：包含 WebAssembly Interface Types（WIT）相关的定义。
• ./.devcontainer/：用于开发环境的 Docker 容器配置。
• ./.github/：包含 GitHub Actions 工作流和其他 GitHub 相关的配置文件。
• ./Cargo.lock：Rust 项目的依赖锁文件。
• ./Cargo.toml：Rust 项目的配置文件。
• ./Dockerfile：用于构建 Docker 容器的配置文件。
• ./Dockerfile.wolfi：用于构建特定 Docker 容器的配置文件。
• ./LICENSE：项目许可证文件。
• ./MAINTAINERS.md：项目维护者列表。
• ./Makefile：用于构建和编译项目的 Makefile 文件。
• ./README.md：项目简介和说明。
• ./SECURITY.md：项目安全策略。
• ./flake.lock：Nix 依赖锁文件。
• ./flake.nix：Nix 项目的配置文件。
• ./rust-toolchain.toml：Rust 工具链配置文件。

2. 项目的启动文件介绍

项目的启动主要通过 wash 命令行工具来完成，该工具会自动启动 NATS、wasmCloud 和 wadm。以下是启动 wadm 的基本步骤：

1. 下载并运行 wash 工具：

   wash up
   

   这条命令会在后台启动 NATS、wasmCloud 和 wadm。

2. 如果你希望单独运行 wadm 或连接到已运行的 wasmCloud 节点，可以下载最新版本的 GitHub 发布构件并执行二进制文件。具体步骤如下：

   curl -fLO https://github.com/wasmCloud/wadm/releases/download/<version>/wadm-<version>-<os>-<arch>.tar.gz
   tar -xvf wadm-<version>-<os>-<arch>.tar.gz
   cd wadm-<version>-<os>-<arch>
   ./wadm
   

   请将 <version>、<os> 和 <arch> 替换为相应的版本号、操作系统和架构。

3. 项目的配置文件介绍

wadm 的配置主要通过 Nix 配置文件和 Rust 配置文件来完成。

• ./flake.nix：这是 Nix 项目的配置文件，用于定义项目依赖和构建过程。

• ./Cargo.toml：这是 Rust 项目的配置文件，用于定义项目依赖和构建参数。

在 flake.nix 文件中，你可以配置项目的依赖项，如 NATS、wasmCloud 和其他必要的库。而在 Cargo.toml 文件中，你可以配置项目的名称、版本、依赖的库和其他构建参数。

此外，项目可能还包含其他配置文件，如 Makefile，用于简化构建过程，以及 Dockerfile，用于创建项目镜像。这些配置文件通常位于项目的根目录下，可以根据项目的具体需求进行修改和调整。