测试你的 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),并在将环境设置为 development (RAILS_ENV=development) 的情况下运行 rails db:migrate 命令。

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

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

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

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

总结

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

相关信息

页面选项