Skip to main content

Deploy infrastructure

Deploy the GDI User Portal on your chosen infrastructure. This guide covers deployment options, containerisation, and environment management for production-ready systems.

Deployment options​

Choose a deployment approach that aligns with your infrastructure requirements and organisational policies.

  • Deploy to ELIXIR-LU: Specific instructions for deploying to ELIXIR Luxembourg infrastructure, tailored for genomic data infrastructure requirements.

  • Configure Docker containers: All components run as Docker containers. Learn about container orchestration, networking, and persistent storage configuration.

  • Manage environments: Best practices for managing multiple environments (development, staging, production) and environment-specific configuration.

Component installation​

  • User Portal Frontend: The frontend provides the web interface and integrates with backend services. Built with Next.js for optimal performance and user experience. Installation guide: User Portal Frontend README↗

  • Dataset Discovery Service (DDS): Backend service that mediates between the frontend and CKAN, providing abstraction and enhanced functionality. To use DDS, ensure that the GDI CKAN extension is installed in your CKAN instance. Installation guide: Dataset Discovery Service README↗

  • Access Management Service (AMS): Handles access requests, user permissions, and integration with external systems like REMS. Installation guide: Access Management Service README↗

  • CKAN Extensions: The platform uses several custom CKAN extensions that must be properly integrated:

    • GDI Userportal Ckanext - Adds a DCAT-AP 3 compatible schema with HealthDCAT support and fields such as issued, modified, has_version, and temporal_start. It also provides enhanced parsing for creators in the DCAT profile, adds support for OpenID Connect with PKCE, introduces new fields to scheming_package_show, and links CKAN harvest views for admin users. Additionally, it offers endpoints for listing unique values and simplifies integration with CKAN-based datasets for the User Portal.

    • DCAT Ckanext - Responsible for mapping DCAT-AP 3 and HealthDCAT to CKAN

    • Fair Datapoint Ckanext - FAIR principles support

    • Harvest Ckanext - Data harvesting capabilities


    CKAN extension integration

    To contribute to a CKAN extension and run it on your local machine, integrate it into the Docker build that will run as your backend service, connected to your DDS instance. For a detailed guide on how to integrate the extension, see Installing new extensions in the CKAN Docker repository.