测试你的 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` 下描述)中只有一个容器。该容器是由 GitHub Actions 在 为你的 Ruby on Rails 应用程序配置 CI/CD 中构建的镜像创建的。
  • 一个 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 db:migrate` 命令,并将环境设置为开发(`RAILS_ENV=development`)。

    通过遵循这些步骤,你可以确保你的数据库在 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 环境中。

相关信息