dotnet tool aspirate
https://www.nuget.org/packages/aspirate/0.1.40-preview
作为全局工具安装
dotnet tool install -g aspirate --prerelease
注意:由于 Aspirete 还在开发中,它现在以预览版的形式发布,使用 --prelease 参数将使用最新的预览版
加工清单
跳转到你的 Aspire 项目中的 AppHost 目录中,然后执行
aspirate generate
该命令 (默认) 将对选中的项目进行构建,然后将容器推送到提供的容器 registry 中。构建可以通过使用参数 --skip-build 来跳过。
默认情况下,你的清单文件将保存在 AppHost/aspirate-output 文件夹中。
如果你愿意,你可以生成一个精简版的 docker-compose 部署,而不是 kubenetes 部署。此时,你可以提供参数 --output-format compose 来达成。请注意,这将导致禁用密钥支持。
aspirate generate --output-format compose
构建
构建命令 build 将构建定义在 aspire 清单中的所有项目,并推送容器到提供的容器 registry 中。
该命令对于重新构建并推送容器到 registry 特别有用,使用一个简单的菜单来选择你希望构建的项目。
该命令将首先创建清单文件,不过该行为可以通过使用参数 --aspire-manifest 或者 -m 并提供现有清单文件的路径来覆盖掉。
aspirate build
密钥管理
Aspirate 现在内置支持强大的密钥管理,允许你简单地加密敏感数据,例如连接串等等。该特性旨在增强安全性和最大限度减少漏洞。
管理密钥
在 generate 和 apply 过程中,系统将提示您输入密码。此密码用于加密位于 aspirate-output 目录中的名为 aspirate-secrets.json 的密钥文件中的密钥。
密钥文件内容
密钥文件包含加密的密钥,可以安全地提交到 Git 存储库。但是,请小心处理此密码。如果丢失,您将无法访问加密的密钥,需要使用 generate 命令创建一个新密钥。
生成密钥
generate 命令在生成过程中提供了一个交互式菜单,允许您使用现有密钥、覆盖它们或更新它们。
应用密钥
apply 命令将解密 secrets 文件,并将 secrets 与所有清单一起应用于群集。
禁用机密管理
如果不需要密钥,则可以将 --disable-secrets 标志传递给所有命令以禁用密钥功能。但是,一旦生成包含机密的清单,则如果不重新生成清单,就无法禁用它们。
应用清单
若要将清单应用于群集,请运行:
aspirate apply
Aspirate 将首先询问您希望操作的上下文,并首先确认您希望采取行动。
删除清单
若要从群集中删除清单,请运行:
aspirate destroy
Aspirate将首先询问希望操作的上下文,并首先确认您希望采取行动。
初始化
init 命令允许您为 Aspire 将使用的 aspire 项目引导某些设置。
- ContainerRegistry:设置此项意味着您不需要在 csproj 中配置,如果找不到它
- 所有构建都将使用它。
- ContainerTag - 将覆盖使用的容器标记(如果不在 csproj 中 - 如果未在设置中指定),将回退到 latest。
- TemplatePath - 这自定义了加载转换为清单的模板时使用的路径,您可以从源中获取模板文件夹,并使用所有自定义更改进行修改,只要您不删除占位符,aspirate 将使用这些占位符而不是其内置。当我们有文档时,更多关于这一点和可能的用例(例如添加作业以创建数据库等)......
要使用 init 命令,只需运行:
aspirate init
从您的 AppHost 目录中 - 它会询问您要覆盖哪些设置。
非交互式调用
除了 generate 之外的所有命令都可以通过传递 --non-interactive 标志以非交互方式调用。如果禁用了机密,则可以使用 Generate。
这将导致工具使用默认上下文,并且不提示确认。
使用此标志时,必须在命令行上传递所有配置参数。
卸载工具
Aspirate 可以通过执行下面的命令进行全局卸载
dotnet tool uninstall -g aspirate
配置 Windows 终端以支持 Unicode 和表情符号
Windows 终端支持 Unicode 和 Emoji。但是,Powershell 和 cmd.exe 等 shell 则不然。有关两者之间的区别,请参阅 控制台、终端和 shell 之间的区别。
对于 PowerShell,以下命令将启用 Unicode 和表情符号支持。您可以将此添加到 profile.ps1 文件中:
[console]::InputEncoding = [console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
对于cmd.exe,需要以下步骤才能启用 Unicode 和 Emoji 支持。
- 运行intl.cpl。
- 单击“管理”选项卡
- 单击“更改系统区域设置”按钮。
- 选中“使用 Unicode UTF-8 获得全球语言支持”复选框。
- 重新启动。
您还需要确保将控制台应用程序配置为使用支持 Unicode 和表情符号的字体,例如 Cascadia Code。
DevContainer 支持
通过安装以下功能,可以在 devcontainer 中使用 Aspirate:
features“: {
“ghcr.io/prom3theu5/aspirational-manifests/aspirate:latest”: {}
}
可以在文档页面上找到 devcontainer 的示例: 详见这里
标签:aspirate,--,命令,密钥,使用,清单,工具 From: https://www.cnblogs.com/haogj/p/18112730