01711c20da
## Description With #613 merged, it is safe to create an `__globals` subgraph into which we can sort all supergraph config. This PR gives supergraph objects a qualified name (using the `__globals` subgraph). Note that outside of debugging/tracing, this is functionally a no-op: we strip the subgraph from the objects as soon as we use them, because the global nature of the config means that this is irrelevant information. <!-- Questions to consider answering: 1. What user-facing changes are being made? 2. What are issues related to this PR? (Consider adding `(close #<issue-no>)` to the PR title) 3. What is the conceptual design behind this PR? 4. How can this PR be tested/verified? 5. Does the PR have limitations? 6. Does the PR introduce breaking changes? --> ## Changelog ### Product _(Select all products this will be available in)_ - [x] community-edition - [x] cloud <!-- product : end : DO NOT REMOVE --> ### Type <!-- See changelog structure: https://github.com/hasura/graphql-engine-mono/wiki/Changelog-Guide#structure-of-our-changelog --> _(Select only one. In case of multiple, choose the most appropriate)_ - [ ] highlight - [ ] enhancement - [ ] bugfix - [x] behaviour-change - [ ] performance-enhancement - [ ] security-fix <!-- type : end : DO NOT REMOVE --> ### Changelog entry <!-- - Add a user understandable changelog entry - Include all details needed to understand the change. Try including links to docs or issues if relevant - For Highlights start with a H4 heading (#### <entry title>) - Get the changelog entry reviewed by your team --> Metadata config declared under the `supergraph` field will now appear as part of an `__globals` subgraph in tracing. Note that the field can also be omitted and the config placed in a user-named subgraph. <!-- changelog-entry : end : DO NOT REMOVE --> <!-- changelog : end : DO NOT REMOVE --> V3_GIT_ORIGIN_REV_ID: 84d2beed98f843df246c8562188cdf7de63643fc |
||
---|---|---|
.circleci | ||
.devcontainer/docs | ||
.github | ||
architecture | ||
assets | ||
cabal | ||
cli | ||
cli-ext | ||
community | ||
console | ||
contrib/metadata-types | ||
dc-agents | ||
docker-compose | ||
docs | ||
frontend | ||
install-manifests | ||
metadata-api-types | ||
nix | ||
packaging | ||
preload-mimalloc | ||
rfcs | ||
scripts | ||
server | ||
translations | ||
v3 | ||
.dockerignore | ||
.envrc | ||
.envrc.local.example | ||
.ghcversion | ||
.git-blame-ignore-revs | ||
.gitignore | ||
.hlint.yaml | ||
.kodiak.toml | ||
.nvmrc | ||
.prettierignore | ||
cabal.project | ||
cabal.project.freeze | ||
CHANGELOG.md | ||
code-of-conduct.md | ||
CONTRIBUTING.md | ||
docker-compose.yaml | ||
event-triggers.md | ||
flake.lock | ||
flake.nix | ||
LICENSE | ||
LICENSE-community | ||
Makefile | ||
metadata.openapi.json | ||
README.md | ||
remote-schemas.md | ||
sample.hie.yaml | ||
SECURITY.md | ||
shell.nix | ||
V2-README.md | ||
yarn.lock |
Hasura GraphQL Engine
The Hasura engine is an open source project which supercharges the building of modern applications by providing access to data via a single, composable, secure API endpoint.
Hasura V2
Hasura V2 is the current stable version of the Hasura GraphQL Engine. Recommended for production use. Please find more
detailed information about the V2 Hasura Graphql Engine in the v2
folder and this README.
Hasura V3
The future of data delivery. Currently in alpha
. Read more
The Hasura V3 engine code, which powers Hasura DDN, is in the V3
folder of this repo. You can find more detailed
information about the Hasura DDN Graphql Engine in this README.
The Hasura DDN architecture includes Data Connectors to connect to data sources. All Hasura connectors are also available completely open source. Check out the Connector Hub which lists all available connectors.
Cloning repository
This repository is a large and active mono-repo containing many parts of the Hasura ecosystem and a long git history, that can make the first time cloning of the repository slow and consume a lot of disk space. We recommend following if you are facing cloning issues.
Shallow clone
This will only clone the latest commit and ignore all historical commits.
git clone https://github.com/hasura/graphql-engine.git --depth 1
Git checkout with only Hasura V3 engine code
git clone --no-checkout https://github.com/hasura/graphql-engine.git --depth 1
cd graphql-engine
git sparse-checkout init --cone
git sparse-checkout set v3
git checkout @
This checkouts the top level files and only the v3
folder which contains the Hasura V3 Engine code.
Support & Troubleshooting
To troubleshoot most issues, check out our documentation and community resources. If you have encountered a bug or need to get in touch with us, you can contact us using one of the following channels:
- Hasura DDN documentation: DDN docs
- Hasura V2 documentation: V2 docs
- Support & feedback: Discord
- Issue & bug tracking: GitHub issues
- Follow product updates: @HasuraHQ
- Talk to us on our website chat
Code of Conduct
We are committed to fostering an open and welcoming environment in the community. Please see the Code of Conduct.
Security
If you want to report a security issue, please read this.
Stay up to date
Join our communities to stay up to date on announcements, events, product updates, and technical blogs. https://hasura.io/community/
Contributing
Check out our contributing guide for more details.
Brand assets
Hasura brand assets (logos, the Hasura mascot, powered by badges etc.) can be found in the v2/assets/brand folder. Feel free to use them in your application/website etc. We'd be thrilled if you add the "Powered by Hasura" badge to your applications built using Hasura. ❤️
Licenses
V2
The V2 core GraphQL Engine is available under the Apache License 2.0 (Apache-2.0).
All other contents in the v2 folder (except those in server
, cli
and
console
directories) are available under the MIT License.
This includes everything in the docs
and community
directories.
V3
The Native Data Connectors are available under the Apache License 2.0.
The core V3 GraphQL Engine is intended to be licensed under Apache 2.0. However, due to certain MPL/GPL dependencies, we are restricted. Hasura intends to update these dependencies soon and publish a long term license under which this code gets available.