ory / keto

Open Source (Go) implementation of "Zanzibar: Google's Consistent, Global Authorization System". Ships gRPC, REST APIs, newSQL, and an easy and granular permission language. Supports ACL, RBAC, and other access models.
https://www.ory.sh/?utm_source=github&utm_medium=banner&utm_campaign=keto
Apache License 2.0
4.7k stars 342 forks source link

Quickstart is outdated #1516

Open alfa-alex opened 3 months ago

alfa-alex commented 3 months ago

Preflight checklist

Ory Network Project

No response

Describe your problem

The Keto Quickstart is based on keto v0.7.0-alpha.1. This is confusing because the instance started by this is not consistent with the API docs that assume the latest keto version (for example, regarding the handling of a non-set max_depth). Updating the version yourself easily is made difficult by the following factors:

After some research I could find out that I can actually use the project's Dockerfile-build via the build make target and just needed to update the folders in the docker-compose.yaml from /home/ory to /home/nonroot. Putting together all these pieces I was able to run a current version of keto via docker.

It would be nice if you could update both the examples and the Quickstart guide. In any case, I hope this issue might help other newcomers who run into the same problems when trying to run a recent version of keto.

Describe your ideal solution

Workarounds or alternatives

Does not apply.

Version

v0.13.0

Additional Context

No response

nmapx commented 3 months ago

I have the same feeling about keto. Once you get started with Hydra/Kratos it's much easier to add other products like Keto and Oathkeeper to the stack. But starting with Keto and outdated documentation might be a problem for less experienced developers. Docker images are usually released right away (was never a problem for me) but indeed v0.13 was published already but the image in registry is missing. The whole topic of Keto releases should be discussed since it's in alpha for a long time now and what is the future of this project in overall in that case?