# DEEP dashboard
<img src="https://marketplace.deep-hybrid-datacloud.eu/images/logo-deep.png" width=200 alt="DEEP-Hybrid-DataCloud logo"/>
Welcome to the DEEP Dashboard, a web user interface to interact with the
[DEEP Platform](https://deep-hybrid-datacloud.eu/the-platform/) resources.
This is still work in progress, under very heavy development.
# Configuration
Please check the sample configuration file that is distributed with the
dashboard. You must pass one to the dashboard, otherwise it will refuse to
start.
## Minimal configuration
The minimal set of options that you must configure in order to run the
dashboard is the following:
[iam]
base_url = <IAM endpoint>
client_id = <OpenID Connect Client ID>
client_secret = <OpenID Connect Client Secret>
[orchestrator]
url = <orchestrator_url>
As you can see, you need to create an OpenID Connect Client in an IAM instance,
then add it to the configuration file. Assuming that you are using the DEEP
production infrastructure, the endpoints can be configured as follows:
[iam]
base_url = "https://iam.deep-hybrid-datacloud.eu"
client_id = <OpenID Connect Client ID>
client_secret = <OpenID Connect Client Secret>
[orchestrator]
url = "https://deep-paas.cloud.ba.infn.it/orchestrator"
The dashboard assumes that it has read and write permissions to the runtime
directory that is configured in the `runtime_dir` configuration option. By
defaul this is set to `/var/run/deep-dashboard/`.
# Running the dashboard
The simplest way is to use the Docker compose with the compose file that is
provided.
First of all, you would need to define a `docker/.env` file, containing
the aforementioned minimal configuration. Validate the docker-compose file
with:
docker-compose -f docker/docker-compose.yml config
Then you can build the containers needed, and start the Docker compose with:
make docker-compose-build
make docker-compose-run
If you wish to use a different environment file, you can do so, indicating it
with the `COMPOSE_LOCAL_ENV` environment variable:
COMPOSE_LOCAL_ENV=foo.env make (...)
Or, directly with Docker compose:
docker-compose -f docker/docker-compose.yml build
docker-compose -f docker/docker-compose.yml --compatibility up --force-recreate
# Acknowledgements
This software has been developed within the DEEP-Hybrid-DataCloud (Designing
and Enabling E-infrastructures for intensive Processing in a Hybrid DataCloud)
project that has received funding from the European Union's Horizon 2020
research and innovation programme under grant agreement No 777435.
Raw data
{
"_id": null,
"home_page": "https://gitlab.ifca.es/deep/deep-dashboard",
"name": "deep-dashboard",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Alvaro Lopez Garcia",
"author_email": "aloga@ifca.unican.es",
"download_url": "https://files.pythonhosted.org/packages/52/ae/f788776b7564a7802d646bac1019ad86ed0cd1b2cb112c06c5876ed476f0/deep-dashboard-0.9.6.tar.gz",
"platform": null,
"description": "# DEEP dashboard\n\n<img src=\"https://marketplace.deep-hybrid-datacloud.eu/images/logo-deep.png\" width=200 alt=\"DEEP-Hybrid-DataCloud logo\"/>\n\nWelcome to the DEEP Dashboard, a web user interface to interact with the\n[DEEP Platform](https://deep-hybrid-datacloud.eu/the-platform/) resources.\n\nThis is still work in progress, under very heavy development.\n\n# Configuration\n\nPlease check the sample configuration file that is distributed with the\ndashboard. You must pass one to the dashboard, otherwise it will refuse to\nstart.\n\n## Minimal configuration\n\nThe minimal set of options that you must configure in order to run the\ndashboard is the following:\n\n [iam]\n base_url = <IAM endpoint>\n client_id = <OpenID Connect Client ID>\n client_secret = <OpenID Connect Client Secret>\n\n [orchestrator]\n url = <orchestrator_url>\n\nAs you can see, you need to create an OpenID Connect Client in an IAM instance,\nthen add it to the configuration file. Assuming that you are using the DEEP\nproduction infrastructure, the endpoints can be configured as follows:\n\n [iam]\n base_url = \"https://iam.deep-hybrid-datacloud.eu\"\n client_id = <OpenID Connect Client ID>\n client_secret = <OpenID Connect Client Secret>\n\n [orchestrator]\n url = \"https://deep-paas.cloud.ba.infn.it/orchestrator\"\n\nThe dashboard assumes that it has read and write permissions to the runtime\ndirectory that is configured in the `runtime_dir` configuration option. By\ndefaul this is set to `/var/run/deep-dashboard/`.\n\n# Running the dashboard\n\nThe simplest way is to use the Docker compose with the compose file that is\nprovided.\n\nFirst of all, you would need to define a `docker/.env` file, containing\nthe aforementioned minimal configuration. Validate the docker-compose file \nwith:\n\n docker-compose -f docker/docker-compose.yml config\n\n\nThen you can build the containers needed, and start the Docker compose with:\n\n make docker-compose-build\n make docker-compose-run\n\nIf you wish to use a different environment file, you can do so, indicating it\nwith the `COMPOSE_LOCAL_ENV` environment variable:\n\n COMPOSE_LOCAL_ENV=foo.env make (...)\n\nOr, directly with Docker compose:\n\n docker-compose -f docker/docker-compose.yml build\n docker-compose -f docker/docker-compose.yml --compatibility up --force-recreate\n\n# Acknowledgements\n\nThis software has been developed within the DEEP-Hybrid-DataCloud (Designing\nand Enabling E-infrastructures for intensive Processing in a Hybrid DataCloud)\nproject that has received funding from the European Union's Horizon 2020\nresearch and innovation programme under grant agreement No 777435.\n\n\n\n",
"bugtrack_url": null,
"license": "Apache-2",
"summary": "This project is the dashboard to interact with the DEEP services.",
"version": "0.9.6",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "1e75568932953cf522c706f046a90a0a",
"sha256": "20ebb23bec04a827e26ba0b4abe037e359f2c8204378aa4b78935277e8917fa0"
},
"downloads": -1,
"filename": "deep-dashboard-0.9.6.tar.gz",
"has_sig": false,
"md5_digest": "1e75568932953cf522c706f046a90a0a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 1095318,
"upload_time": "2022-12-14T12:03:58",
"upload_time_iso_8601": "2022-12-14T12:03:58.265558Z",
"url": "https://files.pythonhosted.org/packages/52/ae/f788776b7564a7802d646bac1019ad86ed0cd1b2cb112c06c5876ed476f0/deep-dashboard-0.9.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-14 12:03:58",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "deep-dashboard"
}
JSON