Edit Environment definition

You can change the behavior and/or content of an Environment by editing the Dockerfile instructions.

Order of script execution

Scripts in an Environment are executed in the following order:

  1. Pre Setup scripts

  2. requirements.txt

  3. Post Setup scripts

  4. Pre Run scripts

  5. Post Run scripts (after the Workspace/Job/App has been stopped)

Note
None of the pre/post scripts are executed for a distributed compute cluster environment (Spark/Ray/Dask/MPI).
Warning
Before every execution, packages are installed from requirements.txt and the pre-setup, post-setup, and pre-run scripts are executed. Before adding to these scripts and requirements.txt, consider whether equivalent instructions can be included in the Environment’s Dockerfile. This will speed up startup for Workspaces, Jobs, and other executions using the Environment, as the work will already be integrated into the Docker image.

Edit Environment definitions

You can modify an Environment by editing its Dockerfile instructions.

Note
If com.cerebro.domino.Environments.canNonSysAdminsCreateEnvironments is false, you need to be an administrator to edit an Environment.

If you just created an Environment and want to edit the Dockerfile instructions to customize the Environment, click Customize before Building.

Environment variables for users and Projects become accessible upon Environment creation. Those specified in /home/ubuntu/.domino-defaults take effect only after the post-setup stage. Note that certain SSL-related configurations are crucial here, impacting the functionality of specific commands during pre/post setup.

To edit an existing Environment, click Environments in the navigation pane and click the name of an Environment.

Overview

Modify the Environment description and set its visibility settings.

Dockerfile instructions

Enter your Dockerfile layers. See Docker’s official site.

Pluggable Workspace Tools

Enter the interactive tools needed by any Project that uses this Environment. See Add Workspace IDEs.

Run Setup Scripts

Enter bash code that is executed at runtime. Domino executes these commands at runtime and runs them as root.

  • Pre Run Script, enter commands to execute after the Python packages in your Project’s requirements.txt are installed.

  • Post Run Script, enter commands to execute after your Workspace/Job/App is stopped.

    Environment variables

    Set the Variable Names and their Values.

    Advanced

    In the advanced section, enter bash code that is executed at a specified step in your experiment’s lifecycle.

  • Pre Setup Script, enter commands to execute before the Python packages in your Project’s requirements.txt are installed.

  • Post Setup Script, enter commands to execute after the Python packages in the requirements.txt of your Project are installed.

    1. In Revision History, enter a short description about the changes to the Environment.

    2. Click Build.