测试你的 Ruby on Rails 部署
先决条件
- 完成本指南的所有先前章节,从容器化 Ruby on Rails 应用程序开始。
- 在 Docker Desktop 中开启 Kubernetes。
概述
在本节中,你将学习如何使用 Docker Desktop 将应用程序部署到开发机器上功能齐全的 Kubernetes 环境中。这使你可以在部署之前在本地 Kubernetes 上测试和调试你的工作负载。
创建 Kubernetes YAML 文件
在你的 docker-ruby-on-rails
目录中,创建一个名为 docker-ruby-on-rails-kubernetes.yaml
的文件。在 IDE 或文本编辑器中打开该文件并添加以下内容。将 DOCKER_USERNAME/REPO_NAME
替换为你的 Docker 用户名以及你在为 Ruby on Rails 应用程序配置 CI/CD 中创建的仓库名称。
apiVersion: apps/v1
kind: Deployment
metadata:
name: docker-ruby-on-rails-demo
namespace: default
spec:
replicas: 1
selector:
matchLabels:
service: ruby-on-rails
template:
metadata:
labels:
service: ruby-on-rails
spec:
containers:
- name: ruby-on-rails-container
image: DOCKER_USERNAME/REPO_NAME
imagePullPolicy: Always
---
apiVersion: v1
kind: Service
metadata:
name: docker-ruby-on-rails-demo
namespace: default
spec:
type: NodePort
selector:
service: ruby-on-rails
ports:
- port: 3000
targetPort: 3000
nodePort: 30001
在此 Kubernetes YAML 文件中,有两个对象,由 ---
分隔。
- 一个 Deployment(部署),描述一组可伸缩的、相同的 Pod。在这种情况下,你将只得到一个副本,或 Pod 的一份拷贝。该 Pod 在
template
下描述,其中只有一个容器。该容器是根据你在为 Ruby on Rails 应用程序配置 CI/CD 中通过 GitHub Actions 构建的镜像创建的。 - 一个 NodePort 服务,它将把流量从主机上的端口 30001 路由到它所路由到的 Pod 内部的端口 8001,从而允许你从网络访问你的应用。
要了解有关 Kubernetes 对象的更多信息,请参阅Kubernetes 文档。
部署并检查你的应用程序
在终端中,导航到
docker-ruby-on-rails
并将你的应用程序部署到 Kubernetes。$ kubectl apply -f docker-ruby-on-rails-kubernetes.yaml
你应该会看到类似以下的输出,表明你的 Kubernetes 对象已成功创建。
deployment.apps/docker-ruby-on-rails-demo created service/docker-ruby-on-rails-demo created
通过列出你的部署来确保一切正常。
$ kubectl get deployments
你的部署应如下所示
NAME READY UP-TO-DATE AVAILABLE AGE docker-ruby-on-rails-demo 1/1 1 1 15s
这表明你在 YAML 中请求的所有一个 Pod 都在运行。对你的服务也进行相同的检查。
$ kubectl get services
你应该会得到类似以下的输出。
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 23h docker-ruby-on-rails-demo NodePort 10.99.128.230 <none> 3000:30001/TCP 75s
除了默认的
kubernetes
服务外,你还可以看到你的docker-ruby-on-rails-demo
服务,它在端口 30001/TCP 上接收流量。要在 Kubernetes 上运行的 Ruby on Rails 应用程序中创建和迁移数据库,你需要按照以下步骤操作。
获取当前 Pod:首先,你需要确定在 Kubernetes 集群中运行的 Pod。执行以下命令以列出
default
命名空间中的当前 Pod# Get the current pods in the cluster in the namespace default $ kubectl get pods
此命令将显示
default
命名空间中所有 Pod 的列表。查找前缀为docker-ruby-on-rails-demo-
的 Pod。这是一个示例输出NAME READY STATUS RESTARTS AGE docker-ruby-on-rails-demo-7cbddb5d6f-qh44l 1/1 Running 2 (22h ago) 9d
执行迁移命令:确定正确的 Pod 后,使用
kubectl exec
命令在 Pod 内部运行数据库迁移。$ kubectl exec -it docker-ruby-on-rails-demo-7cbddb5d6f-qh44l -- rails db:migrate RAILS_ENV=development
此命令在指定的 Pod 中打开一个交互式终端会话 (
-it
),并在将环境设置为 development (RAILS_ENV=development
) 的情况下运行rails db:migrate
命令。通过遵循这些步骤,你可以确保在 Kubernetes 集群中运行的 Ruby on Rails 应用程序中的数据库得到正确迁移。此过程有助于在部署和更新期间维护应用程序数据结构的完整性和一致性。
打开浏览器并访问http://localhost:30001,你应该会看到 Ruby on Rails 应用程序正在运行。
运行以下命令来拆除你的应用程序。
$ kubectl delete -f docker-ruby-on-rails-kubernetes.yaml
总结
在本节中,你学习了如何使用 Docker Desktop 将应用程序部署到开发机器上功能齐全的 Kubernetes 环境中。
相关信息