Err. Why? They are extremely simple. Especially if you follow the
On 3/11/2014 6:06 AM, Stian Thorgersen wrote:
> I find the examples a bit confusing, and also not that great to help people get started building their own apps.
>
screencast tutorials. Most Wildfly developers already know how to set
up web.xml constraints. As a Wildfly developer I just want to see how
Keycloak is wired in. Anything else is a distraction.
? The preconfigured-demo is 3 steps in the appliance-dist:
> One idea would be to have a single configuration of the examples. Only deployable to WildFly and deployed using the subsystem. It would be great to see these deployed (and configured) to Keycloak with a single command ('mvn clean install jboss-as:deploy'?).
>
1. boot keycloak/wildfly
2. load the demo realm through the admin console.
3. mvn clean install jboss-as:deploy
The preconfigured demo works OOTB on both Wildfly, EAP, and AS7. Its
all spelled out in the README.md file in that directory. The examples
*already* use the Wildfly subsystem, just not metadata from
standalone.xml. And that's ok because, IMO, we're not sure yet how
developers will want to deploy keycloak. Many will prefer
keycloak.json, many will prefer standalone.xml.
The unconfigured-demo exists for tutorials, where the tutorial walks you
step by step creating the realm, applications, and users in the admin
console. Then configuring the web applications themselves.
sure, have a repo if you want to, but the examples should be shipped
> Then we'd add a new repo called keycloak-quickstarts. This would contain very basic quickstarts that can be used to get started. Some initial quickstarts we could add:
>
with the distro as well. An example repo requires extra steps to get
the user up and running with Keycloak. It could also get out of sync
with the Keycloak version the user wants to run with. What do you do if
the person doesn't know GIT?
The demo already has most of those examples.
> * Installed application
> * "Local" JavaScript application
> * "Remote" JavaScript application
> * Server-side application (JSF?)
> * Bearer only service
> * Third-party application
> * WildFly deployment
>
I agree we need more examples, I just don't see what's wrong with the
current ones. I've written a lot of examples/tutorials over the years:
EJB, JPA, JAX-RS, now Keycloak. Users prefer insanely simple examples
that focus on the feature they are learning about. Then, one very large
example that brings all the pieces together.
What we're missing is the bigger examples.
--
Bill Burke
JBoss, a division of Red Hat
http://bill.burkecentral.com
_______________________________________________
keycloak-dev mailing list
keycloak-dev@lists.jboss.org
https://lists.jboss.org/mailman/listinfo/keycloak-dev