mirror of
https://github.com/zitadel/zitadel.git
synced 2025-08-12 08:17:46 +00:00

# Which Problems Are Solved The current maintained gRPC server in combination with a REST (grpc) gateway is getting harder and harder to maintain. Additionally, there have been and still are issues with supporting / displaying `oneOf`s correctly. We therefore decided to exchange the server implementation to connectRPC, which apart from supporting connect as protocol, also also "standard" gRCP clients as well as HTTP/1.1 / rest like clients, e.g. curl directly call the server without any additional gateway. # How the Problems Are Solved - All v2 services are moved to connectRPC implementation. (v1 services are still served as pure grpc servers) - All gRPC server interceptors were migrated / copied to a corresponding connectRPC interceptor. - API.ListGrpcServices and API. ListGrpcMethods were changed to include the connect services and endpoints. - gRPC server reflection was changed to a `StaticReflector` using the `ListGrpcServices` list. - The `grpc.Server` interfaces was split into different combinations to be able to handle the different cases (grpc server and prefixed gateway, connect server with grpc gateway, connect server only, ...) - Docs of services serving connectRPC only with no additional gateway (instance, webkey, project, app, org v2 beta) are changed to expose that - since the plugin is not yet available on buf, we download it using `postinstall` hook of the docs # Additional Changes - WebKey service is added as v2 service (in addition to the current v2beta) # Additional Context closes #9483 --------- Co-authored-by: Elio Bischof <elio@zitadel.com>
68 lines
2.4 KiB
JSON
68 lines
2.4 KiB
JSON
{
|
|
"name": "zitadel-docs",
|
|
"version": "0.0.0",
|
|
"private": true,
|
|
"scripts": {
|
|
"docusaurus": "docusaurus",
|
|
"start": "docusaurus start",
|
|
"start:api": "yarn run generate && docusaurus start",
|
|
"build": "yarn run generate && docusaurus build",
|
|
"swizzle": "docusaurus swizzle",
|
|
"deploy": "docusaurus deploy",
|
|
"clear": "docusaurus clear",
|
|
"serve": "docusaurus serve",
|
|
"write-translations": "docusaurus write-translations",
|
|
"write-heading-ids": "docusaurus write-heading-ids",
|
|
"generate": "yarn run generate:grpc && yarn run generate:apidocs && yarn run generate:configdocs",
|
|
"generate:grpc": "buf generate ../proto",
|
|
"generate:apidocs": "docusaurus gen-api-docs all",
|
|
"generate:configdocs": "cp -r ../cmd/defaults.yaml ./docs/self-hosting/manage/configure/ && cp -r ../cmd/setup/steps.yaml ./docs/self-hosting/manage/configure/",
|
|
"generate:re-gen": "yarn generate:clean-all && yarn generate",
|
|
"generate:clean-all": "docusaurus clean-api-docs all",
|
|
"postinstall": "sh ./plugin-download.sh"
|
|
},
|
|
"dependencies": {
|
|
"@bufbuild/buf": "^1.14.0",
|
|
"@docusaurus/core": "^3.8.1",
|
|
"@docusaurus/faster": "^3.8.1",
|
|
"@docusaurus/preset-classic": "^3.8.1",
|
|
"@docusaurus/theme-mermaid": "^3.8.1",
|
|
"@docusaurus/theme-search-algolia": "^3.8.1",
|
|
"@headlessui/react": "^1.7.4",
|
|
"@heroicons/react": "^2.0.13",
|
|
"@inkeep/cxkit-docusaurus": "^0.5.89",
|
|
"autoprefixer": "^10.4.13",
|
|
"clsx": "^1.2.1",
|
|
"docusaurus-plugin-image-zoom": "^3.0.1",
|
|
"docusaurus-plugin-openapi-docs": "4.4.0",
|
|
"docusaurus-theme-github-codeblock": "^2.0.2",
|
|
"docusaurus-theme-openapi-docs": "4.4.0",
|
|
"mdx-mermaid": "^2.0.0",
|
|
"postcss": "^8.4.31",
|
|
"raw-loader": "^4.0.2",
|
|
"react": "^18.2.0",
|
|
"react-copy-to-clipboard": "^5.1.0",
|
|
"react-dom": "^18.2.0",
|
|
"react-google-charts": "^5.2.1",
|
|
"react-player": "^2.15.1"
|
|
},
|
|
"browserslist": {
|
|
"production": [
|
|
">0.5%",
|
|
"not dead",
|
|
"not op_mini all"
|
|
],
|
|
"development": [
|
|
"last 1 chrome version",
|
|
"last 1 firefox version",
|
|
"last 1 safari version"
|
|
]
|
|
},
|
|
"devDependencies": {
|
|
"@docusaurus/module-type-aliases": "^3.8.1",
|
|
"@docusaurus/types": "^3.8.1",
|
|
"tailwindcss": "^3.2.4"
|
|
},
|
|
"packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
|
|
}
|