{"id":19243214,"url":"https://github.com/odpi/egeria-workspaces","last_synced_at":"2026-04-09T22:12:45.438Z","repository":{"id":249171443,"uuid":"830112440","full_name":"odpi/egeria-workspaces","owner":"odpi","description":"Docker compose starter configurations for work, samples, and demos","archived":false,"fork":false,"pushed_at":"2025-03-24T14:54:56.000Z","size":224029,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-01T12:04:25.541Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/odpi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-17T15:59:17.000Z","updated_at":"2025-03-24T14:55:00.000Z","dependencies_parsed_at":"2024-07-19T00:58:38.074Z","dependency_job_id":"354d5f75-9d8e-4c04-99a3-4c933174c346","html_url":"https://github.com/odpi/egeria-workspaces","commit_stats":null,"previous_names":["odpi/egeria-workspaces"],"tags_count":1,"template":false,"template_full_name":"odpi/egeria-template-newrepo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odpi%2Fegeria-workspaces","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odpi%2Fegeria-workspaces/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odpi%2Fegeria-workspaces/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/odpi%2Fegeria-workspaces/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/odpi","download_url":"https://codeload.github.com/odpi/egeria-workspaces/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250032239,"owners_count":21363801,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T17:17:01.141Z","updated_at":"2026-04-09T22:12:45.412Z","avatar_url":"https://github.com/odpi.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- SPDX-License-Identifier: CC-BY-4.0 --\u003e\n\u003c!-- Copyright Contributors to the ODPi Egeria project 2024. --\u003e\n\n# Overview\nThis directory contains sample Docker Compose scripts to support the deployment of Egeria for experimentation,\ndevelopment, and learning. Rather than having to install Egeria, prerequisites and tools separately, these scripts make \nit easy to get a stack running quickly. \nThese are not meant for production use. Please see the [Planning Guide](https://egeria-project.org/guides/planning/)\nfor more information about designing Egeria deployments. The Egeria community has also created samples for other \ndeployment styles, such as Cloud Native approaches and the use of Helm charts to configure Kubernetes clusters. These\noptions may be better starting points for production deployments - depending upon your requirements.\nPlease feel free to engage with the community on our slack channel - we'd love your feedback and participation.\n\n\nFor a quick and simple environment to explore some of Egeria's base capabilities, the **egeria-platform.yml**  Docker Compose\ndeployment may be a good starting point. Once this script executes successfully, you will have two docker containers running. One for the Egeria platform and one for Kafka. With this running configuration, you can work with any of Egeria's standard interfaces - java APIs, python APIs, or just plain RESTful http calls - and of course, to make use of tools and interfaces that have been built using these APIs.\n\nIf you are a data scientist or just want to work within a Jupyter Notebook environment, the `egeria-platform-jupyter-compose` script\nadds a Jupyter server pre-configured with the Egeria Python client, **pyegeria** for you to use.\nThe set of **Docker Compose** configurations will continue to grow and evolve over time to cover additional scenarios based on\ncommunity feedback. \n\n# Contents\n\nOur first docker compose script is called **egeria-platform.yml**. After running this script, you will have a running environment \nthat consists of a single Egeria runtime platform and the Apache Kafka event system. Information about configuring \nEgeria can be found at [Configuring Egeria](https://egeria-project.org/guides/admin/configuring-the-omag-server-platform/). \nWe use standard, out-of-the-box configurations for both - a minimal amount of configuration for:\n\n## Egeria Platform - Default Configuration\nWe use the Egeria platform docker image - [egeria-platform](https://hub.docker.com/r/odpi/egeria-platform).\n\n* Port - By default the platform uses port 9443 and exposes this port to the host environment, This means that Egeria requests\ncan be made to platform URL **https://localhost:9443** or, if your environment is configured to support it, it can use \nthe domain name of your host machine. \n* SSL - By default strict SSL is set to false \n* Auto-Started Servers - by default a useful set of Egeria Open Metadata and Governance (OMAG) servers are pre-installed\nand started when the Egeria platform is started. A description of these servers can be found at [sample configs](https://github.com/odpi/egeria/tree/main/open-metadata-resources/open-metadata-deployment/sample-configs):\n\n  * simple-metadata-store\n  * active-metadata-store\n  * engine-host\n  * integration-daemon\n  * view-server\n\n* Content Packs - pre-constructed information sets that can be used to configure Egeria and pre-load metadata, reference data and glossary data. See [Content Packs](https://egeria-project.org/content-packs/).\n* Out-of-the-box Connectors - descriptions of the integration connectors can be found at [Integration Connectors](https://egeria-project.org/connectors/).\n\n## Kafka - configured for Egeria\nWe use the bitnami/kafka image described at [kafka](https://hub.docker.com/r/bitnami/kafka)\n* Port - We use the default port of 9092 for Kafka. This port is also exposed in the host environment. Changing this port also requires corresponding changes to the Egeria configuration.\n* Other configuration can be seen in the *egeria-platform.yaml* file. \n\n# Usage\nFollow these steps to use Docker Compose.\n\n1. Install and Configure Docker and Docker Compose. \n   * Docker and Docker compose must be installed and running - see https://docs.docker.com/install/\n   * Configure docker with at least 6GB memory\n2. Download the [**egeria-platform.yaml**](https://raw.githubusercontent.com/odpi/egeria/main/open-metadata-resources/open-metadata-deployment/docker-compose/egeria-platform-compose/egeria-platform.yaml)\n3. Run the docker compose script from a terminal window in the directory where you downloaded `egeria-platform.yaml`. At the command line issue:\n\n  `docker compose -f egeria-platform.yaml up`\n\nThis will download the docker images for Kafka and Egeria, then create and start the two containers. Both kafka and Egeria will then automatically configure themselves. For Egeria, this means not only starting up the initial set of servers, but then loading the **CoreContentPack.omarchive** into the metadata repository, and then configuring all the servers. This can take several minutes the first time the containers are created. Subsequent startups will be much faster.\n\n4. Using either the **docker desktop** application or the docker command line you can see the two new containers running. To do this with the docker command line, you can issue:\n\n`docker ps`\n\n5. The environment is ready to be used. \n\n6. You can control the containers with docker compose commands - see [docker compose](https://docs.docker.com/reference/cli/docker/compose/). These commands can be used to administer and use the docker containers.\n\n## Next Steps\n\nNow that your Egeria environment is running and configured it is waiting for you to make requests. \nSome tutorials for working with Egeria can be found at [Tutorials](https://egeria-project.org/education/tutorials/). For those that want to try the new python client, you can find a quick introduction at [pyegeria](https://getting-started-with-egeria.pdr-associates.com/recipe-6-charming-python.html). \n\nAs always, your feedback and participation are welcome. \n\n\nLicense: CC BY 4.0, Copyright Contributors to the ODPi Egeria project.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodpi%2Fegeria-workspaces","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fodpi%2Fegeria-workspaces","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fodpi%2Fegeria-workspaces/lists"}