后端【免费下载链接】pokeapiThe Pokémon API项目地址https://gitcode.com/GitHub_Trending/po/pokeapi点击查看免费下载本文以 PokeAPI 仓库的 README.md 为主线系统梳理这套以 Django Django REST Framework 构建的宝可梦数据 RESTful API 的完整落地路径涵盖本地开发环境搭建、基于 CSV 数据的数据库构建、Docker Compose 多容器部署、Hasura GraphQL 接入以及 Kustomize 驱动的 Kubernetes 集群部署。读者完成阅读后将掌握从零启动 PokeAPI、按 CSV 数据源重建数据库、启用 GraphQL 端点并在生产级容器与集群环境中完成部署与迁移的完整能力。项目概览一套数据驱动的 Django REST APIPokeAPI 是一个面向宝可梦主系列游戏的开放数据接口提供「所有你需要的宝可梦数据集中在一个现代、免费、开源的 RESTful API 中」。从源码结构看它的核心是一条CSV 数据 → 数据库 → 序列化器 → REST 端点的数据流水线数据源仓库data/v2/csv/目录下存放着 200 张 CSV 表如pokemon.csv、moves.csv、abilities.csv、berries.csv、encounters.csv等覆盖宝可梦、招式、特性、树果、遭遇、进化链等全部主题。数据装载data/v2/build.py 中的build_all()负责把 CSV 逐表灌入数据库。Web 框架Django DRF业务模型集中在 pokemon_v2/models.py接口视图与序列化器分别位于 pokemon_v2/api.py 与 pokemon_v2/serializers.py。路由注册pokemon_v2/urls.py 通过自定义的PokeAPIRouter基于 DRFDefaultRouter一次性注册了ability、berry、pokemon、move、type、location-area等 40 个资源端点并额外挂载了api/v2/meta/元信息接口与api/v2/pokemon/{id}/encounters遭遇查询端点。API 配置config/settings.py 中开启仅 JSON 渲染、LimitOffsetPagination分页默认每页 20 条、CORS 全放行并通过drf-spectacular生成 OpenAPI 3.1 规范见 openapi.yml。官方 README 同时说明公共实例承担着每月超过 10 亿次的请求量——这也解释了仓库中为何同时提供 Redis 缓存、Nginx 反向代理与 Kubernetes 部署方案。本地开发环境搭建Setup前置准备克隆仓库并拉取子模块PokeAPI 的数据与资源依赖子模块克隆时必须使用--recurse-submodules标志否则data/v2/csv、sprites 等关键内容将缺失。安装 Python 环境管理工具 [uv]仓库的 Makefile 全面依赖 uv如check-uv目标会在每次执行前校验 uv 是否可用见 Makefile。项目声明支持 Python 3.13见 README 徽章依赖清单由 pyproject.toml 与 uv.lock 锁定。一键安装依赖make install # 等价于uv sync --locked --all-extras --dev # 安装运行与开发所需的全部依赖从 Makefile 可以看到make install实际执行uv sync --locked --all-extras --dev会严格按uv.lock锁定版本安装若仅需运行时最小依赖例如 CI 流水线可使用make install-base对应uv sync --locked --no-dev。安装 pre-commit 钩子推荐make pre-commit-install钩子非强制但 README 推荐用于维持代码质量与一致性。若不想每次提交都自动运行可在提交前手动执行make pre-commit对应uv run pre-commit run --all-files见 Makefile。代码检查lint / format / typecheckmake lint-check # 或: uv run ruff check . make format # 或: uv run ruff format . make typecheck # 或: uv run ty check对应关系可在 Makefile 中核实lint 用 ruff 检查规则见 ruff.tomlformat 用ruff format统一风格typecheck 使用ty check配置见 ty.toml。README 明确指出目前 lint 与 typecheck 尚未严格强制但未来会强制执行建议提交前保证通过。初始化数据库与启动服务make setup # 执行数据库迁移等价于 uv run manage.py migrate --settingsconfig.local make serve # 在 8000 端口启动开发服务器make setup使用本地配置模块config.local见 Makefile它继承 config/settings.py 全部默认设置后将数据库切换为 SQLiteBASE_DIR / db.sqlite3、缓存替换为 DummyCache、并打开 DEBUG见 config/local.py。make serve则等价于uv run manage.py runserver --settingsconfig.local启动后访问 http://localhost:8000/api/v2/ 即可看到 API 根路由。数据库构建与管理从 CSV 构建数据库make build-dbmake build-db内部执行的是echo from data.v2.build import build_all; build_all() | uv run manage.py shell config.local即进入 Django shell 调用data.v2.build.build_all()。README 对它的行为给出了权威描述每次运行都会遍历数据库中的每一张表先清空wipe再使用data/v2/csv中的数据逐行重写。这个全量重建的设计保证了 CSV 数据源永远是数据库的唯一事实来源——任何 CSV 文件的更新只需重新执行一次make build-db即可生效。从 data/v2/build.py 的源码可以进一步看到构建脚本的细节数据目录常量DATA_LOCATION data/v2/csv/与基于__file__推导的DATA_LOCATION2双保险定位 CSV 路径支持通过环境变量POKEAPI_SPRITES_PREFIX/POKEAPI_CRIES_PREFIX覆盖精灵图与叫声资源的 CDN 前缀POKEMON_SPRITE_CONFIG详细定义了正背面、雌性、闪光等 8 种精灵图以及dream_world、home等风格目录的映射见 data/v2/build.py。清空数据库与迁移管理make wipe-sqlite-db # 直接删除本地 db.sqlite3 make make-migrations # 数据库 schema 变更后生成迁移文件 make migrate # 应用待执行的迁移wipe-sqlite-db对应rm -rf db.sqlite3Makefile适用于需要完全重置本地环境的场景。当数据库 schema 发生变化时例如修改了 pokemon_v2/models.py 中的模型先make make-migrations生成迁移迁移历史可见 pokemon_v2/migrations/ 下的 00010037 号文件再make migrate应用。其他常用目标执行make help可查看全部 Makefile 任务目标以# 注释形式自带说明。值得一提的还包括make test # uv run manage.py test config.local运行测试测试见 pokemon_v2/tests.py make openapi-generate # 重新生成 openapi.ymldrf-spectacularDocker Compose 多容器部署对于不想折腾本机依赖、希望一键拉起生产相似环境的场景README 推荐使用 Docker Compose V2 多容器方案。服务拓扑查看 docker-compose.yml 可确认整套编排包含 5 个服务与 3 个持久化卷服务镜像职责cacheredis:8.6.4-alpineRedis 缓存卷redis_datadbpostgres:18.4-alpine3.24PostgreSQL 主库卷pg_data带pg_isready健康检查app本地构建的 PokeAPI 镜像Django 应用depends_ondb健康与 cache启动webnginx:1.31.2-alpine3.23反向代理暴露 80/443 端口挂载 Resources/nginx/nginx.conf 与graphql_cache卷graphql-enginehasura/graphql-engine:v2.50.2Hasura GraphQL 引擎暴露 8080 端口数据库连接参数通过环境变量注入均带默认值POSTGRES_USER默认ash、POSTGRES_PASSWORD默认pokemon、POSTGRES_DB默认pokeapiHasura 侧默认HASURA_GRAPHQL_ADMIN_SECRETpokemon、HASURA_GRAPHQL_UNAUTHORIZED_ROLEanon并显式关闭遥测。一键启动make docker-setup从 Makefile 可见docker-setup是三步的串联docker-updocker compose up -d→docker-migrate执行python manage.py migrate --settingsconfig.docker_compose→docker-build-db在容器内执行build_all()灌入数据。若本机没有 make可按 README 给出的等价命令手动执行docker compose up -d docker compose exec -T app python manage.py migrate --settingsconfig.docker_compose docker compose exec -T app sh -c echo from data.v2.build import build_all; build_all() | python manage.py shell --settingsconfig.docker_compose启动完成后浏览器访问 http://localhost/api/v2/端口 80经 Nginx 代理单条数据示例http://localhost/api/v2/pokemon/bulbasaur/。容器环境下的日常运维make docker-build-db # 应用 CSV 更新重建数据库 make docker-make-migrations # schema 变更后生成迁移 make docker-migrate # 应用迁移 make docker-flush-db # 清空数据但保留表结构与迁移记录 make docker-destroy-db # 移除数据库容器与 pg_data 卷 make docker-test # 在容器内运行测试此外 Makefile 还提供了make docker-prod它会叠加docker-compose.yml docker-compose.override.yml Resources/compose/docker-compose-prod-graphql.yml启动生产形态含 GraphQL 引擎的完整栈。生产版 Compose 文件位于 Resources/compose/docker-compose-prod-graphql.yml应用镜像的构建细节可查看 Resources/docker/app/Dockerfile。GraphQL基于 Hasura Engine 的 Beta 支持README 明确标注Beta GraphQL 支持正在灰度上线。当你用上述 Docker Compose 启动 PokeAPI 时Hasura GraphQL Engine 会一并启动把 PostgreSQL 中的全部 PokeAPI 表自动暴露为 GraphQL 接口。初始化 GraphQL 元数据# 前提hasura cli 已安装并在 $PATH 中且版本高于 v2.50.2 make hasura-applymake hasura-apply对应hasura md apply --project graphql/v1beta2Makefile即把仓库中 graphql/v1beta2/metadata/ 下的 Hasura 元数据数据库表跟踪、角色、允许列表等应用到本地引擎。其中每个public_pokemon_v2_*.yaml文件即一张被跟踪的表。工程配置见 graphql/v1beta2/config.yamlversion: 3、endpoint: http://localhost:8080、metadata_directory: metadata。访问与体验完成后访问 http://localhost:8080 即可进入 Hasura 管理控制台GraphQL 端点托管于http://localhost:8080/v1/graphql官方还提供免费的公共 GraphiQL 控制台beta.pokeapi.co/graphql/console/对应的公开 GraphQL 端点为beta.pokeapi.co/graphql/v1beta。参考示例仓库提供了两套可直接运行的查询示例分别位于 graphql/v1beta/examples 与 graphql/v1beta2/examples包括alola_road_encounters.gql阿罗拉道路遭遇查询best_poison_grass_pokemon.gql毒/草双属性最佳宝可梦筛选item_translations.gql道具多语言翻译查询gen3_species.gql第三代宝可梦物种枚举searchForPokemonInGerman.gql德语名称检索weakestPokemonAbleToBeatFireRedAlone.gql单挑火红版的最弱宝可梦分析。此外 graphql/v1beta2/examples/node/pokemon.js 与 graphql/v1beta2/examples/go/pokemon.go 分别演示了 Node.js 与 Go 客户端调用 GraphQL 端点的完整代码。需要说明的是两套示例目录对应 Hasura 元数据 schema 的 v1beta 与 v1beta2 两个演进版本以 v1beta2 为当前主线。Kubernetes基于 Kustomize 的集群部署PokeAPI 同时提供 Kubernetes 部署方案清单由 Kustomize。第一步准备 Secrets 与配置cp Resources/k8s/kustomize/base/secrets/postgres.env.sample Resources/k8s/kustomize/base/secrets/postgres.env cp Resources/k8s/kustomize/base/secrets/graphql.env.sample Resources/k8s/kustomize/base/secrets/graphql.env cp Resources/k8s/kustomize/base/config/pokeapi.env.sample Resources/k8s/kustomize/base/config/pokeapi.env # 然后编辑这三个新文件填入实际密钥从 kustomization.yaml 可以看到base 通过configMapGenerator与secretGenerator分别消费config/pokeapi.env、secrets/postgres.env与secrets/graphql.env。示例文件给出了最小字段例如 config/pokeapi.env.sample 包含ADMINS、BASE_URL、POKEAPI_CHECKOUT_REF三项PostgreSQL 与 Hasura 的账号、密码、Admin Secret 则分别在对应的*.env.sample中定义。第二步应用清单kubectl apply -k Resources/k8s/kustomize/base/ kubectl config set-context --current --namespace pokeapi # 可选把 pokeapi 设为当前工作 namespacekubectl apply -k会由 Kustomize 渲染并应用 base 下全部资源。从 kustomization.yaml 的resources列表可见它会创建namespace、HAProxy Ingress Controller 及其 RBAC、各类 Servicedefault/pokeapi/postgres/redis/graphql/cloud、PostgreSQL 与 Redis 的 PVC、五个 Deployment以及jobs/load-graphql.yaml这个用于加载 GraphQL 配置的 Job。第三步迁移与建库# 等待集群就绪后在 pod 内执行迁移 kubectl exec --namespace pokeapi deployment/pokeapi -- python manage.py migrate --settingsconfig.docker_compose # 构建数据库灌入 CSV 数据 kubectl exec --namespace pokeapi deployment/pokeapi -- sh -c echo from data.v2.build import build_all; build_all() | python manage.py shell --settingsconfig.docker_compose # 等待 GraphQL 配置 Job 完成 kubectl wait --namespace pokeapi --timeout120s --forconditioncomplete job/load-graphql注意容器内使用的是config.docker_compose配置模块与 Docker 部署一致指向 PostgreSQL。拓扑与资源说明README 对本 K8s 方案给出了明确约定所有资源创建在pokeapinamespace下kubectl delete namespace pokeapi即可整体删除对外暴露一个类型为LoadBalancer的 Service端口80与443相关定义见 services/cloud.yaml数据持久化在12Gi 的 ReadWriteOnce 卷上见 volumes/postgres-persistentvolumeclaim.yaml 与 volumes/redis-persistentvolumeclaim.yaml。除 base 外仓库还在 Resources/k8s/kustomize/ 下提供local、staging、ga三个环境覆盖层overlay并配套 Makefile 目标kustomize-local-apply、kustomize-staging-apply、kustomize-ga-applyMakefile分别使用本地镜像、staging 镜像与 GitHub Actions 配置共享宿主机数据进行部署。Wrappers各语言客户端生态PokeAPI 的 REST 接口被广泛封装README 中列出了官方与社区维护的两组 Wrapper。官方封装包括Node 服务端pokedex-promise-v2支持自动缓存浏览器客户端pokeapi-js-wrapper支持自动缓存与图片缓存Java/KotlinpokekotlinPython 2/3pokepy自动缓存Python 3pokebase自动缓存与图片缓存。社区封装则覆盖了 .NET StandardPokeApiNet、Dartpokedart、Gopokeapi-go、PokeGo、GodotPokeDot、Haxe、PHPphpokeapi、PowerShell、Python 异步aiopokeapi、Ruby、Rustpokerust、Scala、Spring Boot、SwiftPokemonAPI、TypeScriptPokenode-ts等十余种技术栈多数提供自动缓存或懒加载能力。各 Wrapper 的具体仓库地址见仓库 README 的 Wrappers 小节。参与贡献README 明确了贡献流程Fork 项目后使用git clone --recurse-submodules克隆务必包含子模块并创建描述性分支任何 Pull Request 都必须通过既有测试新增功能必须附带新测试提交并推送后发起 PR 描述改动经维护者评审后合入。贡献规范细节可进一步阅读 CONTRIBUTING.md。小结一条完整的落地链路纵览 README 与仓库源码PokeAPI 的部署路径高度一致本地用 uv SQLite 快速起步生产用 Docker ComposePostgreSQL Redis Nginx Hasura形成多容器形态规模化则交给 Kustomize 驱动的 Kubernetes 集群。无论哪条路径数据层都统一由data/v2/build.py的build_all()从data/v2/csv/全量重建保证CSV 即真相接口层则由 Django REST Framework 的 router 统一暴露 40 资源端点并通过 drf-spectacular 生成 OpenAPI 规范。需要排查问题时make help可随时列出全部任务make test与make lint-check则是验证改动质量的快速入口。赞分享后端【免费下载链接】pokeapiThe Pokémon API项目地址https://gitcode.com/GitHub_Trending/po/pokeapi点击查看免费下载相关推荐使用 Docker Compose 部署 Hasura GraphQL Engine 与 Postgres从零开始的完整实战指南使用 Docker Compose 部署 Hasura GraphQL Engine 与 Postgres从零开始的完整实战指南 本篇技术指南以本仓库 ins后端API网关数据库GraphQLAstron Agent 部署路线指南从 Docker Compose 快速起步到 Helm/Kubernetes 生产落地Astron Agent 部署路线指南从 Docker Compose 快速起步到 Helm/Kubernetes 生产落地 Astron Agent 是一套人工智能AI AgentAgent 编排RPA后端前端企业应用HeadlessX 进阶技巧浏览器配置文件管理与自动化任务调度HeadlessX 进阶技巧浏览器配置文件管理与自动化任务调度 HeadlessX 作为一款轻量级自托管无头浏览器自动化平台为开发者提供了强大的浏览器自动化上一篇从 0% 到 90%Fleet 开源项目 Handbook 中的销售机会阶段Opportunity Stages管线管理全解析下一篇Windows 上使用 Conda/Mamba 安装 AutoGluon GPU 版完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考