Apache OpenWhisk 的 `wskdeploy` 安装与使用指南

Apache OpenWhisk 的 wskdeploy 安装与使用指南

openwhisk-wskdeployApache OpenWhisk utility for deploying and managing OpenWhisk projects and packages项目地址:https://gitcode.com/gh_mirrors/op/openwhisk-wskdeploy

本文将介绍如何安装并使用 Apache OpenWhisk 中的 wskdeploy 工具，它是一个用于部署和管理 OpenWhisk 项目的实用程序。

1. 项目目录结构及介绍

在 Apache OpenWhisk-wskdeploy 项目中，主要的目录结构包括：

• src: 包含 wskdeploy 的源代码。
• docs: 存储项目文档，如编程指南和用户手册。
• scripts: 提供脚本以帮助构建、测试和发布 wskdeploy。
• dist: 构建后的可执行文件和资源存储在这里。
• .github: 包含 GitHub 相关的工作流程配置文件。
• LICENSE: 项目许可证信息。
• README.md: 项目简介和快速入门指南。

2. 项目的启动文件介绍

wskdeploy 的启动通常涉及下载预编译的二进制文件或从源代码进行构建。对于预编译的二进制文件，可以在项目 GitHub 发布页面 下载对应操作系统的版本。解压缩后，运行解压后的可执行文件（例如 ./wskdeploy 或 .\wskdeploy.exe）来启动工具。

如果你选择从源代码构建，可以按照以下步骤操作：

1. 克隆仓库: git clone https://github.com/apache/openwhisk-wskdeploy.git
2. 进入源码目录: cd openwhisk-wskdeploy
3. 构建项目: make

完成后，使用 ./build/wskdeploy（Linux 和 macOS）或 .\build\wskdeploy.exe（Windows）执行 wskdeploy。

3. 项目的配置文件介绍

wskdeploy 主要通过两个文件类型来管理工作流：

• Manifest 文件 (.manifest.yml): 描述了要部署到 OpenWhisk 的实体，如动作（actions）、包（packages）和触发器（triggers）。它定义了实体的元数据和依赖关系。
• Deployment 文件 (.deployment.yml): 配置部署设置，例如目标 OpenWhisk 环境的 API 端点和认证信息。它可以引用一个或多个 Manifest 文件。

举个例子，你可以使用以下命令部署一个项目：

wskdeploy -m manifest.yml -d deployment.yml

--projectname 参数可用于在导出项目时为其指定名称，便于管理和重新部署。

此外，wskdeploy export 命令允许你将一组协调工作的 OpenWhisk 实体导出为本地文件系统中的单个项目，这些实体可以作为一个单元进行管理。

总结，wskdeploy 是一个强大的工具，它简化了对 Apache OpenWhisk 的部署和管理，同时提供了对复杂项目结构的支持。通过了解其目录结构、启动文件以及配置文件，你能够更加高效地利用这个工具来维护你的 OpenWhisk 项目。

openwhisk-wskdeployApache OpenWhisk utility for deploying and managing OpenWhisk projects and packages项目地址:https://gitcode.com/gh_mirrors/op/openwhisk-wskdeploy