Skip to content
Snippets Groups Projects
Commit 2c20d58c authored by Samuel GAIST's avatar Samuel GAIST
Browse files

[databases] Add information about how to get environments using Docker

parent 47d928a8
No related branches found
No related tags found
1 merge request!15Add information about the new optional environment field in database
Pipeline #41717 passed
...@@ -149,6 +149,8 @@ and one optional field: ...@@ -149,6 +149,8 @@ and one optional field:
If the environment field is not given, the system will try to find an appropriate environment using the database name as reference. If no database environment declares support for the database, then the execution will fail. If the environment field is not given, the system will try to find an appropriate environment using the database name as reference. If no database environment declares support for the database, then the execution will fail.
The content of name and version follows the same pattern as for the execution environment as can be seen on the `beat environments`_ page. The name is what comes before the parenthesis and the version is the content found between the parenthesis.
The "protocols" field is where the datasets for each protocol is defined. In the example above only one protocol is defined. Implementing a new protocol means adding a new entry to the list of protocols. Each protocol has three main component: The "protocols" field is where the datasets for each protocol is defined. In the example above only one protocol is defined. Implementing a new protocol means adding a new entry to the list of protocols. Each protocol has three main component:
* **name:** The name of the protocol which is "idiap" in this case. * **name:** The name of the protocol which is "idiap" in this case.
...@@ -389,4 +391,26 @@ new evaluation protocols into the platform. Besides, at the experiment level, ...@@ -389,4 +391,26 @@ new evaluation protocols into the platform. Besides, at the experiment level,
this allows to re-use a toolchain on a different database, with almost no this allows to re-use a toolchain on a different database, with almost no
configuration changes from the user. configuration changes from the user.
.. _beat-system-databases-docker:
Databases and Docker
====================
The BEAT docker images can be found on the `beat Docker Hub`_ page.
To get one of the image on your machine, just type the classic Docker command:
$ docker pull beatenv/beat.env.XXX:TAG
Note that there are no "latest" version because of the reproducibility goal of BEAT. Therefore, you will always have to pull the precise version you want to use.
In order to list all the BEAT related Docker images on your machine, use the following command:
$ beat environments list docker
To have a more curated list of images, the following command shows only the database related BEAT images:
$ docker images --format "{{.Repository}}:{{.Tag}}" --filter label="beat.env.type=database"
.. include:: links.rst .. include:: links.rst
...@@ -18,6 +18,9 @@ ...@@ -18,6 +18,9 @@
.. _conda: https://conda.io/ .. _conda: https://conda.io/
.. _beat editor: https://www.idiap.ch/software/beat/docs/beat/docs/new/beat.editor/doc/index.html .. _beat editor: https://www.idiap.ch/software/beat/docs/beat/docs/new/beat.editor/doc/index.html
.. _bob: https://www.idiap.ch/software/bob/docs/bob/docs/stable/bob/doc/index.html .. _bob: https://www.idiap.ch/software/bob/docs/bob/docs/stable/bob/doc/index.html
.. _beat platform: https://www.idiap.ch/software/beat/platform/
.. _beat environments: https://www.idiap.ch/software/beat/platform/backend/environments/
.. _beat Docker Hub: https://hub.docker.com/u/beatenv
.. _idiap: http://www.idiap.ch .. _idiap: http://www.idiap.ch
.. _eigenface: https://en.wikipedia.org/wiki/Eigenface .. _eigenface: https://en.wikipedia.org/wiki/Eigenface
.. _database interfaces: https://www.idiap.ch/software/bob/docs/bob/docs/stable/bob/bob.db.base/doc/index.html .. _database interfaces: https://www.idiap.ch/software/bob/docs/bob/docs/stable/bob/bob.db.base/doc/index.html
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment