hiroyukiosaki/graphql-mesh

GraphQL Mesh Docker（支持Kubernetes/Helm）

运行于 或 /

这是一个用于运行https://github.com/Urigo/graphql-mesh%E7%9A%84%E7%AE%80%E5%8D%95Docker%E9%95%9C%E5%83%8F%EF%BC%88%E6%84%9F%E8%B0%A2https://github.com/Urigo%E5%92%8CMesh%E7%A4%BE%E5%8C%BA%E5%BC%80%E5%8F%91%E7%9A%84%E4%BC%98%E7%A7%80%E5%B7%A5%E5%85%B7%EF%BC%81%EF%BC%89

您只需准备Docker环境或Kubernetes集群即可运行命令，无需了解Node.js。

• GraphQL Mesh Docker（支持Kubernetes/Helm）
• TL;DR
• 架构
• GraphQL Mesh的Docker镜像
• 运行
  • 1. 在Docker上运行
  • 2. 在Kubernetes上运行
    • 2.1 使用kubectl
    • 2.2 使用helm
      • 参数
• 自定义
  • 自定义.meshrc
    • 在Docker上
    • 在Kubernetes（不使用Helm）
    • 使用Helm
  • 克隆现有示例并在Docker中运行
• 示例
  • GraphQL Mesh与MySQL
• 自行构建

TL;DR

sh
# 在Docker上运行
docker run --name mesh -p 4000:4000 -it --volume ${PWD}/docker/work/.meshrc:/work/.meshrc.yaml --rm hiroyukiosaki/graphql-mesh:latest-all-alpine
# 或使用docker-compose运行
cd docker && docker-compose up -d mesh-all-alpine
# 或在Kubernetes上使用helm运行
helm repo add graphql-mesh https://onelittlenightmusic.github.io/graphql-mesh-docker/helm-chart
helm repo up
helm install my-graphql-mesh graphql-mesh/graphql-mesh

然后访问http://localhost:4000。

运行查询：

graphql
{
  cases {
    active
    countryRegion
  }
}

架构

数据源包括MySQL或PostgreSQL等数据库。

https://github.com/Urigo/graphql-mesh%E5%8F%AF%E5%B0%86%E8%BF%99%E4%BA%9B%E6%95%B0%E6%8D%AE%E6%BA%90%E8%BD%AC%E6%8D%A2%E4%B8%BAGraphQL API。

GraphQL Mesh Docker在Docker容器中运行GraphQL Mesh，您可以通过修改.meshrc.yaml并将其挂载到容器中来自定义设置（参见自定义）。

GraphQL Mesh的Docker镜像

• https://hub.docker.com/repository/docker/hiroyukiosaki/graphql-mesh

运行

您可以根据环境选择步骤（Docker或Kubernetes）。

1. 在Docker上运行

只需运行以下命令：

sh
# 直接docker run（选择标签版本）
docker run --name mesh -p 4000:4000 -it --rm hiroyukiosaki/graphql-mesh:latest
docker run --name mesh -p 4000:4000 -it --rm hiroyukiosaki/graphql-mesh:latest-all

替代方案：

sh
# 使用docker-compose
docker-compose up -d mesh
# 或运行vX.X.X-all版本
docker-compose up -d mesh-all

运行镜像后，您可以访问http://localhost:4000查看GraphQL Mesh服务界面。

2. 在Kubernetes上运行

有两种方法：

• kubectl
• helm

您需要Kubernetes集群。如果没有，可以使用https://github.com/kubernetes-sigs/kind%E5%9C%A8Docker%E4%B8%8A%E5%88%9B%E5%BB%BA%EF%BC%9A

sh
kind create cluster --name graphql --config kind-config.yaml

2.1 使用kubectl

sh
# 如果要更改镜像，请编辑k8s/pod.yaml
kubectl apply -f k8s/basic
# 或
kubectl apply -f k8s/jsonschema-covid19

Pod运行后，将Kubernetes服务端口转发到本地：

sh
kubectl port-forward svc/mesh-svc 4000:4000 &

然后访问http://localhost:4000。

2.2 使用helm

sh
# 添加仓库
helm repo add graphql-mesh https://onelittlenightmusic.github.io/graphql-mesh-docker/helm-chart
# 刷新仓库
helm repo up
# 安装helm chart到Kubernetes
helm install my-graphql-mesh graphql-mesh/graphql-mesh
# 或使用参数文件安装
helm install my-graphql-mesh graphql-mesh/graphql-mesh -f <parameter-values.yaml>

参数

详情请参考示例参数值文件。

自定义

有两种方式自定义GraphQL Mesh Docker：

• 自定义.meshrc.yaml
• 克隆现有示例并在Docker中运行

自定义.meshrc

GraphQL Mesh基础用法（官方文档）

• 创建您的.meshrc.yaml，请遵循上述官方文档指南。
• 将.meshrc.yaml放在当前目录。

在Docker上

• 进入docker目录。
• 编辑docker-compose.yaml文件，指向您的.meshrc.yaml并挂载到/work/.meshrc.yaml：

yaml
    volumes:
      - ./.meshrc.yaml:/work/.meshrc.yaml # <- 注释掉并指向您的.meshrc.yaml

• 运行docker-compose up -d mesh

在Kubernetes（不使用Helm）

• 用以下命令覆盖新的ConfigMap资源文件：

sh
kubectl create cm meshrc-cm --from-file .meshrc.yaml --dry-run -o yaml> k8s/basic/meshrc-cm.yaml

• 运行kubectl apply -f k8s/basic

使用Helm

下载示例值文件并编辑以包含您的.meshrc.yaml：

yaml
mount:
  .meshrc.yaml: |-
    sources:
      - name: Ghibli
        handler:
          openapi:
            source: https://ghibliapi.herokuapp.com/swagger.yaml

克隆现有示例并在Docker中运行

sh
# 克隆示例并创建目录"covid-mesh"
git clone https://github.com/jycouet/covid-mesh

# 将该目录挂载到容器并运行
docker run --name mesh -p 4000:4000 -v `pwd`/covid-mesh:/work -it --rm hiroyukiosaki/graphql-mesh:v0.1.17 /bin/bash -c 'yarn install && yarn start'

示例

GraphQL Mesh与MySQL

以下使用https://github.com/Urigo/graphql-mesh/tree/master/examples/mysql-employees%E7%A4%BA%E4%BE%8B%E3%80%82%E6%9B%B4%E7%AE%80%E5%8D%95%E7%9A%84docker-compose%E8%AE%BE%E7%BD%AE%E8%A7%81https://github.com/onelittlenightmusic/graphql-mesh-docker-mysql-example%E3%80%82

sh
git clone https://github.com/datacharmer/test_db.git

# 运行MySQL并恢复员工数据库
docker run --name mysql -v `pwd`/test_db/:/test_db -e MYSQL_ROOT_PASSWORD=passwd -d -p 3306:3306 mysql --default-authentication-plugin=mysql_native_password
docker exec -it mysql /bin/bash
$ cd /test_db
$ mysql < employees.sql -p
# 输入"passwd"

# 克隆示例
git clone https://github.com/Urigo/graphql-mesh.git

# 将该目录挂载到容器并运行  
docker run --name mesh -v `pwd`/graphql-mesh/examples/mysql-employees:/work -p 4000:4000 -d hiroyukiosaki/graphql-mesh:v0.1.17 /bin/bash -c 'sleep 3600'

# 编辑.meshrc.yaml
# 指向主机地址（例如Mac上的host.docker.internal）
#         host: host.docker.internal 

docker exec -it mesh /bin/bash
$ yarn install
$ yarn start

访问http://localhost:4000

自行构建

修改Dockerfile并使用docker-compose命令构建：

sh
docker-compose build