Skip to content

Commit bca8d25

Browse files
doc(config): update configuration documentation with new settings for catalog and reverse proxy (#310)
1 parent 864db92 commit bca8d25

File tree

3 files changed

+19
-4
lines changed

3 files changed

+19
-4
lines changed

docs/docs/devops/getting-started/configuration.md

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,16 +37,28 @@ The root object of the configuration file is the environment object, which conta
3737
| ---- | ----------- | ------------- |
3838
| MODE | This can be either `api` or `orchestrator`, and specifies the mode that the service will run in | api |
3939
| ROOT_PASSWORD | The root password that will be used to update the root password of the virtual machine | |
40-
| DATABASE_FOLDER_ENV_VAR | The folder where the database will be stored | /User/Folder/.prl-devops-service |
40+
| DATABASE_FOLDER| The folder where the database will be stored | /User/Folder/.prl-devops-service |
4141
| DATABASE_NUMBER_BACKUP_FILES | The number of backup files that the database will keep | 10 |
4242
| DATABASE_BACKUP_INTERVAL_MINUTES | The interval in minutes that the database will be backed up in minutes | 120 minutes |
43-
| DATABASE_SAVE_INTERVAL_MINUTES | The interval in minutes that the database will be saved in minytes | 5 minutes |
43+
| DATABASE_SAVE_INTERVAL_MINUTES | The interval in minutes that the database will be saved in minutes | 5 minutes |
4444
| CATALOG_CACHE_FOLDER | The folder where the catalog cache will be stored | /User/Folder/.prl-devops-service/catalog |
45+
| CATALOG_COMPRESS_VM | Specifies whether the virtual machines in the catalog should be compressed | false |
46+
| CATALOG_COMPRESS_VM_RATIO | The ratio that will be used to determine whether the virtual machine should be compressed best_speed/balanced/best_compression/no_compression | best_compression |
47+
| CATALOG_ENABLE_PROVIDER_CREDENTIALS_OBFUSCATION | Specifies whether the provider credentials in the catalog should be obfuscated | true |
48+
| VIRTUAL_MACHINES_FOLDER | The folder where the virtual machines will be stored | users/`<username>`/Parallels |
4549
| PARALLELS_DESKTOP_REFRESH_INTERVAL | The interval in seconds that the service will refresh the Parallels Desktop virtual machines in seconds | 15 seconds |
4650
| SYSTEM_RESERVED_CPU | The number of cpu cores that will be reserved for the system and not used for Orchestrator | 1 |
4751
| SYSTEM_RESERVED_MEMORY | The amount of memory that will be reserved for the system and not used for Orchestrator in Mb's | 2048 |
4852
| SYSTEM_RESERVED_DISK | The amount of disk space that will be reserved for the system and not used for Orchestrator in Mb's | 20000 |
4953
| SYSTEM_AUTO_RECOVER_DATABASE | Specifies whether the system should auto recover the database if it is corrupted | true |
54+
| ENABLE_REVERSE_PROXY | Specifies whether the reverse proxy should be enabled | false |
55+
| REVERSE_PROXY_PORT | The port that the reverse proxy will listen on | 5080 |
56+
| REVERSE_PROXY_HOST | The host that the reverse proxy will listen on | 0.0.0.0 |
57+
| PRL_DEVOPS_LOG_TO_FILE | Specifies whether the logs should be written to a file | false |
58+
| PRL_DEVOPS_LOG_FILE_PATH | if PRL_DEVOPS_LOG_TO_FILE is true, the path to the log file | for root user /var/log/prldevops.log. for normal user users/`<username>`/.prl-devops-service/logs |
59+
| DISABLE_CATALOG_PROVIDER_STREAMING | Specifies whether the catalog provider streaming should be disabled | false |
60+
| ENABLE_CANARY | Specifies whether the canary feature should be enabled | false |
61+
| ENABLE_BETA | Specifies whether the beta feature should be enabled | false |
5062

5163
### Rest API
5264

@@ -61,9 +73,13 @@ The root object of the configuration file is the environment object, which conta
6173
| TLS_PORT | The port that the service will listen on for tls | 8443 |
6274
| TLS_CERTIFICATE | A base64 encoded certificate string | |
6375
| TLS_PRIVATE_KEY | A base64 encoded private key string | |
76+
| TLS_DISABLE_VALIDATION | Specifies whether the service should disable tls validation | false |
77+
| ROOT_PASSWORD | The root password to run the service with | |
6478
| DISABLE_CATALOG_CACHING | Specifies whether the service should disable the catalog caching | false |
79+
| TOKEN_DURATION_MINUTES | The duration in minutes that the token will be valid for in minutes | 60 |
6580
| USE_ORCHESTRATOR_RESOURCES | Specifies whether the service is running in orchestrator mode, which allows the service to use the resources of the orchestrator | false |
6681
| ORCHESTRATOR_PULL_FREQUENCY_SECONDS | The frequency in seconds that the orchestrator will sync with the other hosts in seconds | 30 |
82+
| ENABLE_CORS | Specifies whether the service should enable cors policy | false |
6783
| CORS_ALLOWED_HEADERS | The headers that are allowed in the cors policy | "X-Requested-With, authorization, content-type" |
6884
| CORS_ALLOWED_ORIGINS | The origins that are allowed in the cors policy | "*" |
6985
| CORS_ALLOWED_METHODS | The methods that are allowed in the cors policy | "GET, HEAD, POST, PUT, DELETE, OPTIONS" |

src/constants/main.go

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,6 @@ const (
8585
ENABLE_VAGRANT_PLUGIN_ENV_VAR = "ENABLE_VAGRANT_PLUGIN"
8686
ENABLE_CORS_ENV_VAR = "ENABLE_CORS"
8787
VIRTUAL_MACHINES_FOLDER_ENV_VAR = "VIRTUAL_MACHINES_FOLDER"
88-
EXECUTE_COMMAND_TIMEOUT_ENV_VAR = "EXECUTE_COMMAND_TIMEOUT"
8988
PARALLELS_DESKTOP_REFRESH_INTERVAL_ENV_VAR = "PARALLELS_DESKTOP_REFRESH_INTERVAL"
9089
SYSTEM_RESERVED_CPU_ENV_VAR = "SYSTEM_RESERVED_CPU"
9190
SYSTEM_RESERVED_MEMORY_ENV_VAR = "SYSTEM_RESERVED_MEMORY"

src/install/main.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,7 @@ func getConfigFromEnv() ApiServiceConfig {
213213
config.DisableCatalogCaching = cfg.GetKey(constants.ROOT_PASSWORD_ENV_VAR) == "true"
214214
}
215215
if cfg.GetKey(constants.TOKEN_DURATION_MINUTES_ENV_VAR) != "" {
216-
config.DisableCatalogCaching = cfg.GetKey(constants.TOKEN_DURATION_MINUTES_ENV_VAR) == "true"
216+
config.TokenDurationMinutes = cfg.GetKey(constants.TOKEN_DURATION_MINUTES_ENV_VAR)
217217
}
218218
if cfg.GetKey(constants.MODE_ENV_VAR) != "" {
219219
config.Mode = cfg.GetKey(constants.MODE_ENV_VAR)

0 commit comments

Comments
 (0)