Taipy provides three ways to configure your application :
- A Python configuration
- An explicit file configuration using TOML format
- An environment variable file configuration
Here is a typical workflow that shows how to adapt the configuration of a Taipy application at each stage of a software project (from initial development to production).
To get started, as a developer I will be designing my application by configuring all the new entities (data nodes, tasks, pipelines, scenarios) using the Python code configuration with just a minimal number of attributes configured. The default configuration is used for the other attributes.
Then, I am testing the application built. At this step, I need my application to have a more realistic behavior like real data. For that, I need more configuration. I can specify for my specific input dataset what file to use. I am using the Python code configuration for that.
Then, once I am happy with my application running on my local dev environment, I am deploying it to a remote environment for testing. This is a dedicated environment made for testing deployment and for integration testing. I can then use an explicit TOML file configuration. I can now easily update the file if necessary to be efficient in debugging, without changing the code directly.
Once the step 3 is done, I want to be able to deploy a released and tagged version of my application in several remote environments (e.g. pre-production, production). I am creating one TOML file per remote environment with a few values that differ from step 3, and on each environment, I am setting a different environment variable value to point to the right TOML configuration file.
These methods are described below.
Python code configuration¶
A code configuration can be done on a Python file directly when designing the pipelines and scenarios. This
configuration can be done using methods from the
taipy.Config class. This python configuration is meant to be used
during the application development phase. It overrides the default configuration:
if some values are not provided, the default configuration applies.
Design of the application to configure
Let's imagine we want to configure an application corresponding to the design described in the picture. We use the following python configuration code.
Below is the python code corresponding to the design above.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
plan methods used in lines 22, 24, and 28 are the user functions imported in line
2 from the module
my_functions that represents a user python module.
The following module "my_function" is imported in the python configuration.
1 2 3 4 5 6 7 8 9 10 11 12 13
The following file is the TOML version of the python configuration.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
Note that the type of the non-string configuration attributes is specified in the TOML file by adding at the end of the value (':bool', ':int', or ':float').
Note that in line 15 of the python code, and in line 37 of the TOML export, the password is not exposed. The property's value is a template referencing the environment variable PWD that contains the value. It must be exported as follows:
Explicit TOML file configuration¶
Taipy also provides file configuration. Indeed, a TOML file can be explicitly provided by the developer to the Taipy application using Python coding such as :
1 2 3
This file configuration overrides the attributes in the code configuration (and the default configuration). Here is an example of a TOML file overriding the code configuration provided above as an example :
1 2 3 4 5 6 7
Two behaviors occur if the previous TOML file is used as file configuration. First, the Taipy application now has
five workers (By default, the number of workers is 1). Then, the sales_history data node now is a CSV data node
pointing to the file
./path/to/my/file.csv. All other configuration fields remain unchanged.
Environment variable file configuration¶
Finally, if the environment variable
TAIPY_CONFIG_PATH is defined with the path of a TOML config, Taipy will
automatically load the file and override the previous configurations (explicit file configuration, code configuration
and default configuration).
This functionality can be handy to change the configuration of a Taipy application without having to restart it.
Attribute in an environment variable¶
Configuration can be set dynamically using environment variables with the syntax
ENV[MY_VARIABLE]. This syntax can
be used both in python configuration or TOML configuration. At runtime, Taipy will search for
MY_VARIABLE among the
environment variables then use it.
This can be used to set a different configuration field value depending on the environment on which the application will run. This is also especially useful if you want to use secret strings such as host names, usernames or passwords. For example, if you are using Airflow as a Taipy scheduler, you can hide the password from the configuration file using an environment variable.
Let's take an example with two environment variables. One string password and one integer value. You can export the
NB_WORKERS variables with the following command lines
and refer to it with the following Taipy configuration:
1 2 3
1 2 3
Note that if the type of the configuration attribute is not a string, it must be specified in the TOML file (':bool', ':int', ':float').
Taipy also provides a method to export the compiled configuration applied after the compilation of all the configurations (default, Python code, explicit file, and environment variable configurations) which is the result of the overwriting.
1 2 3