跳到正文

在 Azure 上部署 Kaeso

一台虚拟机运行 Kaeso,用一键部署按钮,或用 Azure CLI 创建。首次启动时,运行安装脚本;通过 Cloud Shell,即可拿到设置链接,无需 SSH。

发布日期
阅读时间
4 分钟
作者
Kaeso Team
明亮的珊瑚色与粉色渐变,呈竖直的褶皱,如同帘幕,一角透着暖光

Kaeso 的 Azure 模板是一台快速服务器:一台虚拟机上的 Compose 软件包,与您自己的服务器相同,带有负责 TLS 的 Caddy、用于请求日志的内置 ClickHouse 和更新器。它不需要自己的域名就能启动,因为 Azure 会给这台机器一个 DNS 名称,Caddy 会为它获取证书。整个部署大约需要五分钟。

仓库中的 deploy/azure/ 存放 Azure 资源管理器模板,旁边的 createUiDefinition.json 决定门户中表单的样子。

您会得到什么

  • 一个只有一个子网的虚拟网络,以及一个网络安全组:只允许 HTTP、HTTPS 和 HTTP/3 进入,SSH 只对您给出的地址范围开放。
  • 一个静态公共地址,带有 <region>.cloudapp.azure.com 下的 DNS 名称。
  • 一台 Ubuntu 24.04 虚拟机,启用受信任启动和启动诊断,带 40 GB 磁盘,默认是 Standard_B2als_v2,2 个 vCPU 和 4 GB 内存。
  • 一个自定义脚本扩展,在首次启动时运行 Kaeso 的安装脚本:它安装 Docker,写入设置,并启动 Compose 软件包。

模板中不含 Kaeso 的任何机密。安装脚本会在服务器上生成主密钥和各个密码。

用按钮部署

  1. 打开 Deploy to Azure(在新标签页中打开) 并登录。门户从 prod 分支读取模板,该分支包含最新版本。
  2. 选择一个订阅、一个新资源组和一个区域,并填写下面的参数。
  3. 创建部署,等待它完成。安装脚本运行完毕,部署才会完成。
  4. 在部署的 Outputs 下,复制 setupLink,在 Azure Cloud Shell(在新标签页中打开) 或用 Azure CLI 运行它。它无需 SSH 就能打印一次性设置链接。打开该链接,创建第一个用户。
  5. 如果有自己的域名,把它的 CNAME 记录指向输出 fqdn,或把 A 记录指向 publicIp。Caddy 会一直重试,直到域名能够解析,然后获取证书。

用 Azure CLI 部署

在仓库的一个克隆中,创建一个资源组,并把模板部署到其中:

az group create --name kaeso --location westeuropeaz deployment group create --resource-group kaeso \  --template-file deploy/azure/quick-server.json \  --parameters domain=kaeso.example.com \  adminPasswordOrKey="$(cat ~/.ssh/id_ed25519.pub)" sshSourceAddress=203.0.113.0/24

部署完成后,该命令会打印各项输出。像上面第 4 步那样,运行其中的 setupLink。

参数

参数含义
domainKaeso 应答的域名;留空则使用该地址的 DNS 名称
dnsLabel该地址在 <region>.cloudapp.azure.com 下的 DNS 名称;留空则根据资源组生成
kaesoVersion要安装的版本;留空则安装最新的稳定版本
vmSize、diskSizeGb、diskType默认是 Standard_B2als_v2、40 GB 和标准 SSD
adminUsername、authenticationType、adminPasswordOrKey服务器的管理员,使用 SSH 公钥或密码
sshSourceAddress可以访问 SSH 的地址范围;留空则保持端口 22 关闭
location区域;默认与资源组相同

保存主密钥

Kaeso 用 /opt/kaeso/master-keys 中的主密钥加密服务商密钥,因此没有它,数据库备份就无法读取。请把一份副本与备份分开保存:运行输出 setupLink 中的命令,把脚本换成 cat /opt/kaeso/master-keys 即可打印它,然后存入密码管理器。

更新

更新方式与任何 Compose 实例相同:从控制台更新,在您选择的时间窗口内自动更新,或手动更新。模板只负责创建服务器;再次部署它并不会更新 Kaeso。

须知

  • 这里只有快速服务器。仓库中还没有使用 Azure Container Apps、Azure Database for PostgreSQL 和托管缓存的模板。
  • 这些规格都是 x64 的。如需 Arm64 规格,请部署 Arm64 版的 Ubuntu 24.04,并手动运行安装脚本。

已验证的内容

模板通过了 Microsoft 的 ARM 模板测试工具包。它尚未从空白的 Azure 账户部署过;同一个安装脚本已在 AWS 和 Google Cloud 上部署过。如果您部署了,请告诉我们结果如何。

下一步

作者:Kaeso Team

本页内容

网关归您。记录也归您。

curl -fsSLhttps://kaeso.app/install.sh | sh