Natively supported Job types
The following lists the supported file types and the commands that Domino executes when it runs the file type:| Language | Filetype/Keyword | Invocation |
|---|---|---|
| Python | py | python -u |
| R | r | R --no-save --no-environ --no-site-file --no-restore --max-ppsize=100000 |
| Markdown | rmd/rhtml | R -e require('knitr'); knit('file_name') |
| Bash | sh | bash file_name |
| Matlab | m/mlx/mexa64 | matlab –sd $(dirname file_name) -batch |
| Perl | pl | perl file_name |
| Julia | jl | julia file_name |
| Python notebook | ipynb | ipython nbconvert -to notebook --execute file_name --output file_name |
| SAS | sas | sas file_name -stdio |
| Stata | do | stata -b do |
Custom Job types
Domino supports executing nearly any type of user application code to achieve a wide variety of computational scenarios by editing an Environment definition to support your needs.This feature is disabled by default. To use this feature, please reach out to Domino Support.
What is a file handler?
When you run a Job, Domino automatically handles the execution of the file. For natively supported file types, Domino already has commands it runs based on the file extension. To execute a file extension that isn’t natively supported, or to run a different command for a file extension that is in the list, you can use a file handler. A file handler is a bash script with the name of the file extension (without the.sh extension), located in /opt/domino/handlers/{extension}.
File handler examples
The file handler lives in the Environment’s file system, so the execution of the Job depends on the Environment in which you run the Job.-
The file handler
/opt/domino/handlers/jpegtargets files with the.jpegextension. -
The file handler
/opt/domino/handlers/pyoverrides the default behavior for.pyfiles.
Add a file handler through the Domino UI
To add a file handler through the Domino UI, edit an Environment definition.- Click Environments in the Domino sidebar.
-
In the Dockerfile instructions field, create a directory for the custom file handler:
-
Add the commands you want to execute when you invoke the file. Save the custom commands to a file with the same name as the file extension you want to target:
Add a file handler through the terminal
To add a file handler through the terminal, you must build a Docker image and upload it to an external repository. You can use the Docker image to create an Environment that contains your file handler.-
Create a directory for the custom file handler:
-
Add the commands you want to execute when you invoke the file. Save the custom commands to a file with the same name as the file extension you want to target:
-
Save a copy of this file to a Docker image:
-
Build the Docker image and upload it to an external repository associated with your Project.
Share a custom file handler
When you add custom file handlers to an Environment, the file handlers are associated with that Environment’s Docker image. Each Environment has its own Docker image. You can only have one Docker image per Environment. If you must use your custom file handler in another Environment, you have several alternatives:- If the file handler is in the Dockerfile instructions field, you can copy and paste the handler’s commands into the same field in a different Environment.
-
If the file handler is in a Docker image in an external repository:
- Use the Docker image as a base to build Docker images for any Environment that needs your custom file handler.
- Upload the file handler itself to an external repository. You can reference this file from multiple Docker images.