8000 Documentation for Quarkus distribution · Issue #9034 · keycloak/keycloak · GitHub
[go: up one dir, main page]

Skip to content

Documentation for Quarkus distribution #9034

Closed

Activity

  1. added this to the 17.0.0 milestone on Dec 7, 2021
  2. added
    priority/blockerHighest Priority. Has a deadline and it blocks other tasks
    kind/enhancementCategorizes a PR related to an enhancement
    on Dec 7, 2021
  3. pedroigor commented on Jan 5, 2022

    @pedroigor
    ContributorAuthor

    @DGuhr @stianst Here is what I have in mind as the very first guides we should be looking at:

    1. Configuring Keycloak
    • Main configuration aspects of the server (e.g.: build/runtime configuration, how to check if a configuration is related to build or runtime)
    • Why building a server image is important for optimal startup and how to do it
    • Briefly explain the format of configuration options: CLI, ENV, properties
    • Configuration file: keycloak.properties
    • Property replacement
    • Configuration Profiles
    1. Managing providers
    • Explain how to deploy custom providers
    • Explain how to configure providers
    1. Configuring Keycloak for Optimal Runtime
    • More detailed guide about how to optimize Keycloak to run faster and with lower memory footprint
    • Examples on how to extend docker image
    • Examples on how to do it in bare metal
    1. Configuring a Database
    • Explain how to configure a database
    • Explain how to externalize database credentials using a vault (quarkus-based approach)
    1. Enabling TLS
    • Explain how to enable TLS
    1. Configuring Clustering
    • Explain the main concepts around clustering (e.g.: config file, cache modes, cache stacks)
    • Clustering on Kubernetes
    1. Exposing Keycloak Endpoints
    • Explain how to configure Keycloak hostname provider
    1. Enabling/Disabling Features
    • Explain how to enable/disable features
    1. Configuring a Vault
    • How to use mounted secrets
    • How to use Hashicorp
    1. Deploying in Production
    • Explain the necessary configuration and steps about how to deploy in production
    • The idea is to explain the steps and probably have some references to other guides like database, proxy, clustering, etc. And also references to our official doc?
    1. Starting in Development Mode
    • Explain the core concepts behind dev mode
    • Explain how to debug the server
    1. Running a container
    • Explain how to run Keycloak as a container
    • Explain how to create custom container images

    Perhaps some of the items above could be split into different guides.

  4. bs-matil commented on Jan 5, 2022

    @bs-matil
    Contributor

    Is the order artificial? If not I would like to kindly ask to put the dev experience tasks (14.) earlier so the community could easier start to contribute. Also its handy in case of SPI development to know how those can be tested in that context

  5. andreaTP commented on Jan 6, 2022

    @andreaTP
    Contributor

    Should we add a section like "Migration from Wildfly distribution"?
    Mentioning e.g. bulk import/export, configuration changes etc.

  6. pedroigor commented on Jan 6, 2022

    @pedroigor
    ContributorAuthor

    Is the order artificial? If not I would like to kindly ask to put the dev experience tasks (14.) earlier so the community could easier start to contribute. Also its handy in case of SPI development to know how those can be tested in that context

    Yeah, it is artificial. We should try to deliver all of them at once.

  7. pedroigor commented on Jan 6, 2022

    @pedroigor
    ContributorAuthor
  8. DGuhr commented on Jan 7, 2022

    @DGuhr
    Contributor

    See #9432 for a first draft PR for Point 1 of your list

  9. olivierboudet commented on Jan 13, 2022

    @olivierboudet
    Contributor

    Hello,

    For the clustering part, besides you wrote : Explain the main concepts around clustering (e.g.: config file, cache modes, cache stacks), I would like to emphasis on the infinispan remote store configuration.

  10. moved this from Todo to In Progress in Keycloak: Quarkus distributionon Jan 25, 2022
  11. added
    area/dist/quarkusQuarkus distribution — packaging, container images, server config (kc.sh)
    on Jan 27, 2022
  12. changed the title [-]Documentation[/-] [+]Documentation for Quarkus distribution[/+] on Feb 4, 2022
  13. Repository owner moved this from In Progress to Done in Keycloak: Quarkus distributionon Feb 4, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area/dist/quarkusQuarkus distribution — packaging, container images, server config (kc.sh)kind/enhancementCategorizes a PR related to an enhancementpriority/blockerHighest Priority. Has a deadline and it blocks other tasks

Type

No type

Fields

No fields configured for issues without a type.

Projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions

0