Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • to make global settings such as paths etc. available from environment variables for shell jobs.
  • to store encrypted secrets to Job Resources variables that can be decrypted by jobs. For details see JS7 - How to encrypt and decrypt Variables.
  • to store configuration files to Job Resource variables. The JS7 will make the configuration file available from temporary files per job instance with releated Agents. Configuration files can be encrypted before being added to Job Resources, accordingly jobs can decrypt configuration files on-the-fly. On termination of the job instance temporary files are removed by JS7 Agents.

...

...

Code Block
languagepowershell
titleExample for Update of a Job Resource Variable
linenumberstrue
Set-JS7JobResource `
    -Path /ProductDemo/Variables/pdConfigurationData `
    -Key configurationData `
    -File ./config.ini `
    -EnvVar 'CONFIGURATION_DATA'

# updates the "configurationData" Job Resource variable "configurationData" from the configuration file specified
# receiving jobs use the "CONFIGURATION_DATA" environment variable that specifies the path to a temporary file holding the configuration data

...

Code Block
languagepowershell
titleExample for Update of a Job Resource Variable
linenumberstrue
Set-JS7JobResource `
    -Path /ProductDemo/Variables/pdBusinessSecret `
    -Key businessSecret `
    -Value 'secret' `
    -EnvVar 'BUSINESS_SECRET' `
    -EncryptCertificatePath $env:JS7_AGENT_CONFIG_DIR/foobar.crt `
    -JavaLib $env:JS7_AGENT_HOME/lib
 
# updates the Job Resource variable "businessSecret" from the somegiven value
# encrypts the value of the "businessSecret" variable will be encrypted using an Agent's certificate from the foobar.crt file
# specifies the valuelocation of the "businessSecret" variable holds the encrypted symmetric key, initialization vector and encrypted secret
# the JS7 encryption libraries specifiedthat with -JavaLib ship with Agents and that are available for download if used outside of JS7 products

...

Code Block
languagepowershell
titleExample for Update of a Job Resource Variable
linenumberstrue
Set-JS7JobResource `
    -Path /ProductDemo/Variables/pdConfigurationDataSecret `
    -Key configurationDataSecret` `
    -File ./config.ini `
    -EnvVar 'CONFIGURATION_DATA_SECRET' `
    -EncryptCertificatePath $env:JS7_AGENT_CONFIG_DIR/foobar.crt `
    -JavaLib $env:JS7_AGENT_HOME/lib
 
# updates the "configurationDataSecret" Job Resource variable "configurationDataSecret" from the configuration file specified
# encryptes the contentscontent of the file will be encrypted using the target Agent's certificate from the foobar.crt file
# creates anthe additional variable "configurationDateSecret_key" and the environment variable "CONFIGURATION_DATA_SECRET_KEYkey" will be created that both hold the encrypted symmetric key and initialization vector
# specifies the location of the JS7 encryption libraries specifiedthat with -JavaLib ship with Agents and that are available for download if used outside of JS7 products

...