fedormelexin/graphql-engine-arm64

graphql-engine-arm64镜像文档

概述

本镜像为Hasura GraphQL Engine提供arm64/aarch64架构支持，可在Nvidia Jetson Nano、树莓派4（Rpi4）和Apple M1等arm64设备上运行。项目仓库：https://github.com/melehin/graphql-engine-arm64

核心功能和特性

• 基于官方Hasura GraphQL Engine构建，保持一致的功能特性
• 专为arm64/aarch64架构优化，支持多种嵌入式和边缘设备
• 提供灵活的部署方式，支持Docker命令行和docker-compose
• 支持Hasura控制台访问和管理
• 兼容官方Hasura的环境变量配置

使用场景和适用范围

• 在arm64架构设备上部署GraphQL服务
• 边缘计算环境中的API服务构建
• 嵌入式系统中的数据访问层实现
• 开发和测试环境中的GraphQL引擎快速部署

使用方法

使用docker run启动实例

通过以下命令在aarch64设备上启动Hasura实例：

bash
docker run -d -p 8080:8080 \
  -e HASURA_GRAPHQL_DATABASE_URL=postgres://username:password@hostname:port/dbname \
  -e HASURA_GRAPHQL_ENABLE_CONSOLE=true \
  -e HASURA_GRAPHQL_ADMIN_SECRET=myadminsecretkey \
  fedormelexin/graphql-engine-arm64

Hasura控制台将在 http://localhost:8080 可用。

使用docker-compose部署

⚠️ 请将MYPGDBPASSWORD替换为您的密码或生成新密码！ 如需设置管理员密钥，请取消注释HASURA_GRAPHQL_ADMIN_SECRET并设置密码。 可使用以下命令生成随机密码：

bash
dd if=/dev/random bs=128 count=1 2>/dev/null | sha1sum

以下是包含Hasura和PostgreSQL的docker-compose示例配置：

yaml
version: '3.6'
services:
  postgres:
    image: postgres
    restart: always
    volumes:
    - db_data:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: MYPGDBPASSWORD 
  graphql-engine:
    image: fedormelexin/graphql-engine-arm64
    ports:
    - "8080:8080"
    depends_on:
    - "postgres"
    restart: always
    environment:
      HASURA_GRAPHQL_DATABASE_URL: postgres://postgres:MYPGDBPASSWORD@postgres:5432/postgres
      HASURA_GRAPHQL_ENABLE_CONSOLE: "true" # 设置为"false"以禁用控制台
      ## 取消注释下一行设置管理员密钥
      # HASURA_GRAPHQL_ADMIN_SECRET: myadminsecretkey
volumes:
  db_data:

镜像版本

DockerHub上的镜像版本：

• 最新镜像（可能比官方发布晚1-2天）：fedormelexin/graphql-engine-arm64:latest

查看所有版本：https://hub.docker.com/r/fedormelexin/graphql-engine-arm64/tags?page=1&ordering=last_updated

从源码构建

构建v2.0.2及以上版本

bash
export DOCKER_USERNAME=fedormelexin
export HASURA_VERSION=v2.0.5
git clone https://github.com/melehin/graphql-engine-arm64
cd graphql-engine-arm64
docker build --build-arg HASURA_VER=${HASURA_VERSION} -t "${DOCKER_USERNAME}/graphql-engine-arm64:${HASURA_VERSION}" .

构建带CLI迁移的版本（v2.0.2及以上）

支持v2或v3版本的CLI迁移：

bash
export DOCKER_USERNAME=fedormelexin
export HASURA_VERSION=v2.0.5
export SCRIPT_VERSION=v3
git clone https://github.com/melehin/graphql-engine-arm64
cd graphql-engine-arm64/cli-migrations
docker build --build-arg SCRIPT_VERSION=${SCRIPT_VERSION} --build-arg SERVER_IMAGE_TAG=${HASURA_VERSION} --build-arg SERVER_IMAGE=${DOCKER_USERNAME}/graphql-engine-arm64  -t "${DOCKER_USERNAME}/graphql-engine-arm64:${HASURA_VERSION}.cli-migrations-${SCRIPT_VERSION}" .

构建v2.0.1及以下版本

请使用ghc-8.10.2分支：

bash
git clone -b ghc-8.10.2 https://github.com/melehin/graphql-engine-arm64