测试您的 Ruby on Rails 部署

先决条件

概述

在本节中,您将学习如何使用 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 文档

部署和检查您的应用程序

  1. 在终端中,导航到 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
  2. 通过列出您的部署来确保一切正常。

    $ 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 上接受流量。

  3. 要创建和迁移在 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),并使用设置为开发环境 (RAILS_ENV=development) 的环境运行 rails db:migrate 命令。

    通过执行这些步骤,您可以确保您的数据库在 Kubernetes 集群中运行的 Ruby on Rails 应用程序中正确迁移。此过程有助于在部署和更新期间维护应用程序数据结构的完整性和一致性。

  4. 打开浏览器并访问 https://127.0.0.1:30001,您应该看到 Ruby on Rails 应用程序正在运行。

  5. 运行以下命令来拆除您的应用程序。

    $ kubectl delete -f docker-ruby-on-rails-kubernetes.yaml
    

总结

在本节中,您学习了如何使用 Docker Desktop 将您的应用程序部署到您开发机器上的功能齐全的 Kubernetes 环境。

相关信息