Conductor is a flexible Docker Compose setup that simplifies the process of spinning up Overture development and deployment configurations using Docker profiles and extensible scripting events.
PROFILE environment variable.1. Clone the repo's main branch
git clone -b concerto https://github.com/overture-stack/composer.git && cd composer2. Run one of the following commands to spin up different environments:
| Environment | Unix/macOS | Windows |
|---|---|---|
| Overture Platform | make platform |
make.bat platform |
| Stage Dev | make stageDev |
make.bat stageDev |
| Arranger Dev | make arrangerDev |
make.bat arrangerDev |
| Maestro Dev | make maestroDev |
make.bat maestroDev |
| Song Dev | make songDev |
make.bat songDev |
| Score Dev | make scoreDev |
make.bat scoreDev |
Each command spins up complementary services for the specified development environment.
.
├── conductorScripts/
│ ├── deployments
│ └── services
├── configurationFiles/
│ ├── arrangerConfigs
│ ├── elasticsearchConfigs
│ └── keycloakConfigs
├── guideMaterials
├── persistentStorage/
│ ├── data-keycloak-db
│ ├── data-minio
│ └── data-song-db
├── Makefile
└── make.batconductorScripts/ Contains scripts for orchestrating the deployment process.
deployments/: Scripts that execute service scripts sequentially based on the deployment configuration. These also include custom post-deployment logs with essential next steps for the deployment scenario.services/: Modular scripts for individual service setup tasks. Each file is named according to its purpose, with inline comments documenting the code.configurationFiles/ Stores all required configuration files, including:
arrangerConfigs/: Configuration files specific to Arranger.elasticsearchConfigs/: Configuration files for Elasticsearch, encompassing indexing mappings and documents for seeding data.keycloakConfigs/: Configuration files for Keycloak, including preconfigured realm files and Overture API key provider details.guideMaterials/ Supplementary folders and files for use with the Overture guides.
persistentStorage/ Directory for storing persistent data during container startups and restarts. These folders come pre-loaded with mock data.
data-keycloak-db/: Persistent local storage for the Keycloak database.data-minio/: Persistent local storage for MinIO object storage.data-song-db/: Persistent local storage for the Song database.Makefile Contains make commands for Unix-based systems (macOS, Linux) to streamline Docker operations.
make.bat Windows equivalent of the Makefile, featuring batch commands tailored for Windows systems.