Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-06-03. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

创建 Redis 服务容器

您可以使用服务容器在工作流程中创建 Redis 客户端。 本指南举例说明如何为容器中运行或直接在运行器机器上运行的作业创建 Redis 服务。

注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

简介

本指南演示了使用 Docker Hub redis � 像配置服务容器的工作流程示例。 工作流程运行脚本来创建 Redis 客户端并使用数据填充客户端。 要测试工作流程是否创建并填充 Redis 客户端,脚本会将客户端数据打印到控制台。

Note: If your workflows use Docker container actions, job containers, or service containers, then you must use a Linux runner:

  • 如果您要使用 GitHub 托管的运行器,则必须使用 Ubuntu 运行器。
  • 如果您要使用自托管运行器,则必须使用 Linux 机器作为运行器,并且必须安装 Docker。

基本要求

您应该熟悉服务容器如何与 GitHub Actions 协同作用,以及直接在运行器上或在容器中运行任务之间的网络差异。 更多信息请参阅“关于服务容器”。

� 可能还会发现它也有助于基本了解 YAML、GitHub Actions 的语法和 Redis。 更多信息请参阅:

在容器中运行作业

配置要在容器中运行的作业可简化作业与服务容器之间的网络配置。 同一用户定义的桥接网络上的 Docker 容器互相显示所有端口,� 此您� 需将任何服务容器端口� 射到 Docker 主机。 您可以使用工作流程中配置的� �签从作业容器访问服务容器。

您可以将此工作流程文件复制到仓库的 .github/workflows 目录,并� �据需要进行修改。

YAML
name: Redis container example
on: push

jobs:
  # Label of the container job
  container-job:
    # Containers must run in Linux based operating systems
    runs-on: ubuntu-latest
    # Docker Hub image that `container-job` executes in
    container: node:10.18-jessie

    # Service containers to run with `container-job`
    services:
      # Label used to access the service container
      redis:
        # Docker Hub image
        image: redis
        # Set health checks to wait until redis has started
        options: >-
          --health-cmd "redis-cli ping"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

    steps:
      # Downloads a copy of the code in your repository before running CI tests
      - name: Check out repository code
        uses: actions/checkout@v2

      # Performs a clean installation of all dependencies in the `package.json` file
      # For more information, see https://docs.npmjs.com/cli/ci.html
      - name: Install dependencies
        run: npm ci

      - name: Connect to Redis
        # Runs a script that creates a Redis client, populates
        # the client with data, and retrieves data
        run: node client.js
        # Environment variable used by the `client.js` script to create a new Redis client.
        env:
          # The hostname used to communicate with the Redis service container
          REDIS_HOST: redis
          # The default Redis port
          REDIS_PORT: 6379

配置容器作业

此工作流程配置在 node:10.18-jessie 容器中运行的作业,并使用 ubuntu-latest GitHub 托管的运行器作为容器的 Docker 主机。 有关 node:10.18-jessie 容器的更多信息,请参阅 Docker Hub 上的节点� 像

工作流程用 Redis � �签配置服务容器。 所有服务必须在容器中运行,� 此每个服务都需要指定容器� 像。 此示例使用 redis 容器� 像,并包括状态检查选项以确保服务正在运行。 更多信息请参阅 Docker Hub 上的 redis � 像

YAML
jobs:
  # Label of the container job
  container-job:
    # Containers must run in Linux based operating systems
    runs-on: ubuntu-latest
    # Docker Hub image that `container-job` executes in
    container: node:10.18-jessie

    # Service containers to run with `container-job`
    services:
      # Label used to access the service container
      redis:
        # Docker Hub image
        image: redis
        # Set health checks to wait until redis has started
        options: >-
          --health-cmd "redis-cli ping"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

配置步骤

工作流程执行以下步骤:

  1. 检出运行器上的仓库
  2. 安装依赖项
  3. 运行脚本来创建客户端
YAML
steps:
  # Downloads a copy of the code in your repository before running CI tests
  - name: Check out repository code
    uses: actions/checkout@v2

  # Performs a clean installation of all dependencies in the `package.json` file
  # For more information, see https://docs.npmjs.com/cli/ci.html
  - name: Install dependencies
    run: npm ci

  - name: Connect to Redis
    # Runs a script that creates a Redis client, populates
    # the client with data, and retrieves data
    run: node client.js
    # Environment variable used by the `client.js` script to create a new Redis client.
    env:
      # The hostname used to communicate with the Redis service container
      REDIS_HOST: redis
      # The default Redis port
      REDIS_PORT: 6379

client.js 脚本寻找 REDIS_HOSTREDIS_PORT 环境变量来创建客户端。 工作流程将这两个环境变量设置为“连接到 Redis”步骤的一部分,使它们可用于 client.js 脚本。 有关脚本的更多信息,请参阅“测试 Redis 服务容器”。

Redis 服务的主机名是您在工作流程中配置的� �签,本例中为 redis。 由于同一用户定义的网桥网络上的 Docker 容器默认打开所有端口,� 此您将能够访问默认 Redis 端口 6379 上的服务容器。

直接在运行器机器上运行作业

直接在运行器机器上运行作业时,需要将服务容器上的端口� 射到 Docker 主机上的端口。 您可以使用 localhost 和 Docker 主机端口号从 Docker 主机访问服务容器。

您可以将此工作流程文件复制到仓库的 .github/workflows 目录,并� �据需要进行修改。

YAML
name: Redis runner example
on: push

jobs:
  # Label of the runner job
  runner-job:
    # You must use a Linux environment when using service containers or container jobs
    runs-on: ubuntu-latest

    # Service containers to run with `runner-job`
    services:
      # Label used to access the service container
      redis:
        # Docker Hub image
        image: redis
        # Set health checks to wait until redis has started
        options: >-
          --health-cmd "redis-cli ping"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        ports:
          # Maps port 6379 on service container to the host
          - 6379:6379

    steps:
      # Downloads a copy of the code in your repository before running CI tests
      - name: Check out repository code
        uses: actions/checkout@v2

      # Performs a clean installation of all dependencies in the `package.json` file
      # For more information, see https://docs.npmjs.com/cli/ci.html
      - name: Install dependencies
        run: npm ci

      - name: Connect to Redis
        # Runs a script that creates a Redis client, populates
        # the client with data, and retrieves data
        run: node client.js
        # Environment variable used by the `client.js` script to create
        # a new Redis client.
        env:
          # The hostname used to communicate with the Redis service container
          REDIS_HOST: localhost
          # The default Redis port
          REDIS_PORT: 6379

配置运行器作业

示例使用 ubuntu-latest GitHub 托管的运行器作为 Docker 主机。

工作流程用 Redis � �签配置服务容器。 所有服务必须在容器中运行,� 此每个服务都需要指定容器� 像。 此示例使用 redis 容器� 像,并包括状态检查选项以确保服务正在运行。 更多信息请参阅 Docker Hub 上的 redis � 像

工作流程将 Redis 服务容器上的端口 6379 � 射到 Docker 主机。 有关 ports 关键字的更多信息,请参阅“关于服务容器”。

YAML
jobs:
  # Label of the runner job
  runner-job:
    # You must use a Linux environment when using service containers or container jobs
    runs-on: ubuntu-latest

    # Service containers to run with `runner-job`
    services:
      # Label used to access the service container
      redis:
        # Docker Hub image
        image: redis
        # Set health checks to wait until redis has started
        options: >-
          --health-cmd "redis-cli ping"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        ports:
          # Maps port 6379 on service container to the host
          - 6379:6379

配置步骤

工作流程执行以下步骤:

  1. 检出运行器上的仓库
  2. 安装依赖项
  3. 运行脚本来创建客户端
YAML
steps:
  # Downloads a copy of the code in your repository before running CI tests
  - name: Check out repository code
    uses: actions/checkout@v2

  # Performs a clean installation of all dependencies in the `package.json` file
  # For more information, see https://docs.npmjs.com/cli/ci.html
  - name: Install dependencies
    run: npm ci

  - name: Connect to Redis
    # Runs a script that creates a Redis client, populates
    # the client with data, and retrieves data
    run: node client.js
    # Environment variable used by the `client.js` script to create
    # a new Redis client.
    env:
      # The hostname used to communicate with the Redis service container
      REDIS_HOST: localhost
      # The default Redis port
      REDIS_PORT: 6379

client.js 脚本寻找 REDIS_HOSTREDIS_PORT 环境变量来创建客户端。 工作流程将这两个环境变量设置为“连接到 Redis”步骤的一部分,使它们可用于 client.js 脚本。 有关脚本的更多信息,请参阅“测试 Redis 服务容器”。

主机名为 localhost127.0.0.1

测试 Redis 服务容器

您可以使用以下脚本测试工作流程,该脚本将创建 Redis 客户端,并使用某些� 位符数据填充客户端。 然后,脚本将存储在 Redis 客户端中的值打印到终端。 您的脚本可以使用任何您喜欢的语言,但此示例使用 Node.js 和 redis npm 模块。 更多信息请参阅 npm redis 模块

您可以修改 client.js 以包含工作流程需要的任何 Redis 操作。 在此示例中,脚本创建 Redis 客户端实例、添� � 位符数据,然后检索数据。

使用以下代� �将名为 client.js 的新文件添� 到仓库。

JavaScript
const redis = require("redis");

// Creates a new Redis client
// If REDIS_HOST is not set, the default host is localhost
// If REDIS_PORT is not set, the default port is 6379
const redisClient = redis.createClient({
  host: process.env.REDIS_HOST,
  port: process.env.REDIS_PORT  
});

redisClient.on("error", function(err) {
    console.log("Error " + err);
});

// Sets the key "octocat" to a value of "Mona the octocat"
redisClient.set("octocat", "Mona the Octocat", redis.print);
// Sets a key to "octocat", field to "species", and "value" to "Cat and Octopus"
redisClient.hset("species", "octocat", "Cat and Octopus", redis.print);
// Sets a key to "octocat", field to "species", and "value" to "Dinosaur and Octopus"
redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print);
// Sets a key to "octocat", field to "species", and "value" to "Cat and Robot"
redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print);
// Gets all fields in "species" key

redisClient.hkeys("species", function (err, replies) {
    console.log(replies.length + " replies:");
    replies.forEach(function (reply, i) {
        console.log("    " + i + ": " + reply);
    });
    redisClient.quit();
});

该脚本使用 createClient 方法创建新的 Redis 客户端,接受 hostport 参数。 该脚本使用 REDIS_HOSTREDIS_PORT 环境变量来设置客户端的 IP 地址和端口。 如果未定义 hostport,则默认主机为 localhost,默认端口为 6379。

该脚本使用 sethset 方法,以一些键值、字段和值来填充数据库。 要确认 Redis 客户端是否包含数据,脚本会将数据库的内容打印到控制台日志。

运行此工作流程时,应会在“连接到 Redis”步骤中看到以下输出,确认您创建了 Redis 客户端并添� 了数据:

Reply: OK
Reply: 1
Reply: 1
Reply: 1  
3 replies:
    0: octocat
    1: dinotocat
    2: robotocat