如何在 Windows 上轻松搭建 Hasura 本地环境

简介

Hasura 是一个开源的 GraphQL 引擎，允许开发人员通过简洁的 API 查询和操作数据。它可以连接到各种数据源，如 PostgreSQL、MySQL、MongoDB 等，并自动生成 GraphQL 架构和查询功能。Hasura 还提供了丰富的特性，例如数据权限控制、实时订阅、REST API 等。

先决条件

• Windows 操作系统
• Docker Desktop 已安装
• 已安装文本编辑器

步骤

1. 安装 Docker Compose

• 打开 Docker Desktop 应用程序。
• 在 Docker 设置中，导航到“Features”选项卡。
• 找到“Docker Compose”选项并确保已启用。

2. 下载 Hasura 镜像

• 在命令提示符下运行以下命令：

  docker pull hasura/graphql-engine
  

3. 创建 Docker Compose YAML 文件

• 创建一个名为 docker-compose.yml 的文件，并将以下内容复制到其中：

  version: '3.7'
  
  services:
    hasura:
      image: hasura/graphql-engine:latest
      ports:
        - "8080:8080"
      environment:
        - HASURA_GRAPHQL_ENABLED=true
        - HASURA_GRAPHQL_DATABASE_URL=postgres://postgres:mysecretpassword@postgres:5432/postgres
      depends_on:
        - postgres
  
    postgres:
      image: postgres:latest
      ports:
        - "5432:5432"
      environment:
        - POSTGRES_PASSWORD=mysecretpassword
  

• 将 postgres:mysecretpassword 和 postgres:5432/postgres 替换为您的实际密码和数据库名称。

4. 启动 Hasura 和 PostgreSQL 容器

• 在命令提示符下，导航到 docker-compose.yml 文件所在的目录。

• 运行以下命令启动容器：

  docker-compose up -d
  

5. 访问 Hasura 控制台

• 打开浏览器并导航到 http://localhost:8080。
• 您将看到 Hasura 控制台。

6. 测试 Hasura

• 在控制台的左侧边栏中，单击“Data”选项卡。
• 在“Tables”下，您将看到一个名为 public.users 的表。
• 单击该表以查看其详细信息。
• 在“Queries”选项卡下，您可以看到一些预定义的查询。
• 单击“Run”按钮以运行查询。

7. 清理

• 要停止 Hasura 和 PostgreSQL 容器，请运行以下命令：

  docker-compose down
  

结论

您已成功在 Windows 上搭建了 Hasura 本地环境。现在，您可以开始使用 Hasura 开发 GraphQL API 并连接到您的数据库。