在本页
如何将 Deno 部署到 Digital Ocean
Digital Ocean 是一个流行的云基础设施提供商,提供从网络、计算到存储等多种托管服务。
这是使用 Docker 和 GitHub Actions 将 Deno 应用程序部署到 Digital Ocean 的分步指南。
此项操作的先决条件是
创建 Dockerfile 和 docker-compose.yml 跳转到标题
为了专注于部署,我们的应用程序将只是一个 main.ts
文件,它返回一个字符串作为 HTTP 响应
import { Application } from "https://deno.land/x/oak/mod.ts";
const app = new Application();
app.use((ctx) => {
ctx.response.body = "Hello from Deno and Digital Ocean!";
});
await app.listen({ port: 8000 });
然后,我们将创建两个文件 -- Dockerfile
和 docker-compose.yml
-- 以构建 Docker 镜像。
在我们的 Dockerfile
中,让我们添加
FROM denoland/deno
EXPOSE 8000
WORKDIR /app
ADD . /app
RUN deno install --entrypoint main.ts
CMD ["run", "--allow-net", "main.ts"]
然后,在我们的 docker-compose.yml
中
version: "3"
services:
web:
build: .
container_name: deno-container
image: deno-image
ports:
- "8000:8000"
让我们在本地测试一下,运行 docker compose -f docker-compose.yml build
,然后运行 docker compose up
,并访问 localhost:8000
。
它工作了!
构建、标记和推送你的 Docker 镜像到 Digital Ocean 容器注册表 跳转到标题
Digital Ocean 有自己的私有容器注册表,我们可以使用它来推送和拉取 Docker 镜像。为了使用这个注册表,让我们在命令行上安装并验证 doctl
。
之后,我们将创建一个名为 deno-on-digital-ocean
的新私有注册表
doctl registry create deno-on-digital-ocean
使用我们的 Dockerfile 和 docker-compose.yml,我们将构建一个新的镜像,标记它,并将其推送到注册表。请注意,docker-compose.yml
会在本地将构建命名为 deno-image
。
docker compose -f docker-compose.yml build
让我们用 new
标记它
docker tag deno-image registry.digitalocean.com/deno-on-digital-ocean/deno-image:new
现在我们可以将其推送到注册表。
docker push registry.digitalocean.com/deno-on-digital-ocean/deno-image:new
你应该在你的Digital Ocean 容器注册表中看到带有 new
标签的新 deno-image
完美!
通过 SSH 部署到 Digital Ocean 跳转到标题
一旦我们的 deno-image
进入注册表,我们就可以使用 docker run
在任何地方运行它。在本例中,我们将在我们的 Digital Ocean Droplet(他们的托管虚拟机)中运行它。
在你的 Droplet 页面上,单击你的 Droplet,然后单击 console
以 SSH 进入虚拟机。(或者你可以直接从你的命令行 ssh 进入。)
为了拉取 deno-image
镜像并运行它,让我们运行
docker run -d --restart always -it -p 8000:8000 --name deno-image registry.digitalocean.com/deno-on-digital-ocean/deno-image:new
使用我们的浏览器访问 Digital Ocean 地址,我们现在看到
砰!
通过 GitHub Actions 自动化部署 跳转到标题
让我们使用 GitHub actions 自动化整个过程。
首先,让我们获取登录 doctl
和 SSH 进入 Droplet 所需的所有环境变量
- DIGITALOCEAN_ACCESS_TOKEN
- DIGITALOCEAN_HOST (你的 Droplet 的 IP 地址)
- DIGITALOCEAN_USERNAME (默认值为
root
) - DIGITALOCEAN_SSHKEY (更多信息见下文)
生成 DIGITALOCEAN_SSHKEY
跳转到标题
DIGITALOCEAN_SSHKEY
是一个私钥,其公钥对应部分存在于虚拟机中的 ~/.ssh/authorized_keys
文件中。
为了做到这一点,首先让我们在你的本地机器上运行 ssh-keygen
ssh-keygen
当提示输入电子邮件时,请务必使用你的 GitHub 电子邮件,以便 GitHub Action 正确验证身份。你的最终输出应该看起来像这样
Output
Your identification has been saved in /your_home/.ssh/id_rsa
Your public key has been saved in /your_home/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:/hk7MJ5n5aiqdfTVUZr+2Qt+qCiS7BIm5Iv0dxrc3ks user@host
The key's randomart image is:
+---[RSA 3072]----+
| .|
| + |
| + |
| . o . |
|o S . o |
| + o. .oo. .. .o|
|o = oooooEo+ ...o|
|.. o *o+=.*+o....|
| =+=ooB=o.... |
+----[SHA256]-----+
接下来,我们将不得不将新生成的公钥上传到你的 Droplet。你可以使用 ssh-copy-id
,或者手动复制它,ssh 进入你的 Droplet,并将其粘贴到 ~/.ssh/authorized_keys
。
使用 ssh-copy-id
ssh-copy-id {{ username }}@{{ host }}
此命令将提示你输入密码。请注意,这将自动从你的本地机器复制 id_rsa.pub
密钥并将其粘贴到你的 Droplet 的 ~/.ssh/authorized_keys
文件中。如果你将你的密钥命名为 id_rsa
以外的其他名称,你可以使用 -i
标志将其传递给命令
ssh-copy-id -i ~/.ssh/mykey {{ username }}@{{ host }}
为了测试这是否成功完成
ssh -i ~/.ssh/mykey {{ username }}@{{ host }}
太棒了!
定义 yml 文件 跳转到标题
最后一步是将所有这些放在一起。我们基本上是在手动部署期间执行每个步骤,并将它们添加到 GitHub Actions 工作流 yml 文件中
name: Deploy to Digital Ocean
on:
push:
branches:
- main
env:
REGISTRY: "registry.digitalocean.com/deno-on-digital-ocean"
IMAGE_NAME: "deno-image"
jobs:
build_and_push:
name: Build, Push, and Deploy
runs-on: ubuntu-latest
steps:
- name: Checkout main
uses: actions/checkout@v2
- name: Set $TAG from shortened sha
run: echo "TAG=`echo ${GITHUB_SHA} | cut -c1-8`" >> $GITHUB_ENV
- name: Build container image
run: docker compose -f docker-compose.yml build
- name: Tag container image
run: docker tag ${{ env.IMAGE_NAME }} ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ env.TAG }}
- name: Install `doctl`
uses: digitalocean/action-doctl@v2
with:
token: ${{ secrets.DIGITALOCEAN_ACCESS_TOKEN }}
- name: Log in to Digital Ocean Container Registry
run: doctl registry login --expiry-seconds 600
- name: Push image to Digital Ocean Container Registry
run: docker push ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ env.TAG }}
- name: Deploy via SSH
uses: appleboy/ssh-action@master
with:
host: ${{ secrets.DIGITALOCEAN_HOST }}
username: ${{ secrets.DIGITALOCEAN_USERNAME }}
key: ${{ secrets.DIGITALOCEAN_SSHKEY }}
script: |
# Login to Digital Ocean Container Registry
docker login -u ${{ secrets.DIGITALOCEAN_ACCESS_TOKEN }} -p ${{ secrets.DIGITALOCEAN_ACCESS_TOKEN }} registry.digitalocean.com
# Stop and remove a running image.
docker stop ${{ env.IMAGE_NAME }}
docker rm ${{ env.IMAGE_NAME }}
# Run a new container from a new image
docker run -d --restart always -it -p 8000:8000 --name ${{ env.IMAGE_NAME }} ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ env.TAG }}
当你推送到 GitHub 时,此 yml 文件会自动被检测到,从而触发 Deploy action。