{"id":21615202,"url":"https://github.com/eea/eea.docker.bise.catalogue","last_synced_at":"2026-04-11T00:42:59.732Z","repository":{"id":32641469,"uuid":"36227838","full_name":"eea/eea.docker.bise.catalogue","owner":"eea","description":"BISE Catalogue docker orchestration","archived":false,"fork":false,"pushed_at":"2018-04-16T09:11:06.000Z","size":57,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":33,"default_branch":"master","last_synced_at":"2025-03-14T23:02:36.678Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://biodiversity.europa.eu/bise-catalogue","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-25T11:37:53.000Z","updated_at":"2018-04-16T09:10:46.000Z","dependencies_parsed_at":"2022-09-09T20:11:29.531Z","dependency_job_id":null,"html_url":"https://github.com/eea/eea.docker.bise.catalogue","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.bise.catalogue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.bise.catalogue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.bise.catalogue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Feea.docker.bise.catalogue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eea","download_url":"https://codeload.github.com/eea/eea.docker.bise.catalogue/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244266091,"owners_count":20425825,"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-24T22:10:50.909Z","updated_at":"2025-12-31T00:15:23.263Z","avatar_url":"https://github.com/eea.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eea.docker.bise.catalogue\n\n[BISE Catalogue](https://github.com/eea/bise.catalogue) docker orchestration\n\nA BISE Catalogue deployment requires [Docker](https://docs.docker.com/installation/) at least 1.6 and [Docker Compose](https://docs.docker.com/compose/install/) at least 1.2 running on a host with a Linux Kernel 3.16 or newer.\n\n## Development instance\n\n    docker-compose -f development.yml build\n    docker-compose -f development.yml run --rm web bundle exec rake db:create db:migrate db:seed\n\nTo get admin rights, start the instance, login with Eionet LDAP account, then:\n\n    docker-compose -f development.yml run db psql -U postgres -h db\n    \\c catalogue_development;\n    update users set role_admin='t';\n    CTRL+D\n\nThis updates the catalogue_development database and sets the admin flag for all existing users.\n\n## Prerequisites\n\nCopy `bise-catalogue/config/ldap.example.yml` into `bise-catalogue/config/ldap.yml` and modify it with the LDAP admin credentials for EIONET.\n\n**IMPORTANT**: Use the ldap server in the same network/as close as posible to the production.\n\nEdit a `.secret` file for Postfix SMTP authentication, see: http://github.com/eea/eea.docker.postfix for more details.\n\n## Start\n\n    docker-compose up\n\nCheck the web application is running on localhost:80 (default port, can be changed in development.yml file).\n\n### Production deployment\n\n### Initial setup\n\n**Step 1**: Clone the repo. Setup secrets\n\n    git clone https://github.com/eea/eea.docker.bise.catalogue.git\n    cd eea.docker.bise.catalogue\n    cp bise-catalogue/config/ldap.example.yml bise-catalogue/config/ldap.yml\n    # edit ldap.yml, add authentication and ldap server\n    touch .secret\n    # edit .secret, add authentication to the email server, see https://github.com/eea/eea.docker.postfix/blob/master/.secret.example for more details\n\n**Step 2**: Start the containers\n\n(we need to start them once so the data volumes are created)\n\n     docker-compose up -d\n\n**Step 3a**: Initialise database (for new setup only)\n\n     docker exec -it eeadockerbisecatalogue_web_1 bundle exec rake db:create db:migrate\n\n**Step 3b**: Migrate existing database (for migrating data from an existing installation)\n\nTODO: this information is old, update instructions.\n\n(we are using two scripts to fetch data from an existing instance and another one to push it into the data containers)\n\n     docker-compose stop\n     cd data\n     ./fetch.sh\n     for DATA_ID in eeadockerbisecatalogue_data_1 eeadockerbisecatalogue_dataw1_1 eeadockerbisecatalogue_dataw2_1; do\n     ./put.sh\n     done\n     cd -\n     docker-compose up -d\n\n**Step 4**: Check installation\n\n     curl localhost\n\n**Extra**: How to get admin rights\n\nLogin using your EIONET ldap account, then issue:\n\n    docker exec -it eeadockerbisecatalogue_db_1 bash\n    su postgres\n    psql\n    \\c catalogue_production;\n    update users set role_admin='t';\n    CTRL+D\n\nThe Docker service should expose a frontend nginx container on the port 80.\n\n### Migrating between servers\n\n**Step0**: Locate where the instrumentation checkout sits on the disk. This should be a git clone of this project. Try /root or /var/local/deploy\n\n**Step1**: In this location, use the data/make_backups.py script to make a backup of the proper Docker volumes.\n\n**Step2**: Copy this location to the new server. It will have all necesarry configuration files already setup. Optional: use eeacms/rsync Docker image to perform the copy operation between servers.\n\n**Step3**: Use 'sh install.sh' script to install the containers on this new server.\n\nIf anything goes wrong, use 'sh uninstall.sh' script to remove all containers and start all over again.\n\n**Step4**: See elasticsearch.txt on how to migrate ES data using snapshots\n\n\n### Code changes / re-deployment\n\nAny changes to the eea/bise.catalogue repository will trigger a new build in Docker Hub: https://registry.hub.docker.com/u/eeacms/bise.catalogue/\n\nTo apply them on production, run:\n\n    cd eea.docker.bise.catalogue\n    docker pull eeacms/bise.catalogue:latest\n    docker-compose stop\n    docker-compose up -d\n    docker exec -it eeadockerbisecatalogue_web_1 rake db:migrate\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feea%2Feea.docker.bise.catalogue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feea%2Feea.docker.bise.catalogue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feea%2Feea.docker.bise.catalogue/lists"}