Rebar ESB Environment Variables

Monkton, Inc. 2019

Rebar ESB has a series of environment variriables that configure specific configuration items for deployment.

These can be, but are not limited to:

  • Configuration Settings
  • Cloud Configuration Items
  • Database Connection Strings

Almost all of the environment variables can be overriden by configurations deployed to cloud environments like AWS S3. In those instances, the configuration settings are deployed as a JSON file with variable:value mappings.

Sql Connections

All Aurora or MySql connections should have the SslMode attribute set to SslMode=Required. Failure to do so will cause the MySql engine to not encrypt traffic over the wire.

General Environment Variables

Variable Name Description Name Required
REBAR_DATABASE_KIND Set to mysql Yes
REBAR_CONFIG_SOURCE Set to env Yes
REBAR_DISABLE_SSL Defaults to false, this should be set to true in development or if in a Docker container with an nginx proxy. No
REBAR_DOCKER_URLS A comma separated list of urls that can access the .NET Core Runtime App running Rebar. Example: http://*:5959 Yes
REBAR_DB_NAME The name of the Rebar Database to be accessed. We strongly suggest rebar Yes
REBAR_CORE The MySql/Aurora connection string for the specific service. This connection string shall be formatted in the following manner: SslMode=Required;User Id=;Password=;Data Source= Initial Catalog=rebar; MinimumPoolSize=5; MaximumPoolSize=1000; Pooling=true; ConnectionLifeTime=30; Convert Zero Datetime=True;

For each environment you must substitude the following usernames for the appropriate environment being deployed to:
rebar_web_apis for the Rebar API
rebar_web_admn for the Rebar Admin
rebar_web_svcs for the Rebar Jobs
Yes
REBAR_SA_CONNECTION_STRING The MySql/Aurora connection string for the SA account. This account shall be formatted in the following manner: SslMode=Required;User Id=rebaradmin;Password= XXXXXXXXXXXXXXXXXXXXXXXXXXXX;Data Source=;Pooling=false;, leaving the XXXXXXXXXXXXXXXXXXXXXXXXXXXX value in place. The password is injected when the user is prompted during setup or database updates.

This value is only required with the Rebar Admin Docker container.
Yes
REBAR_DOCKER Defaults to false, this should be set to true in development or if in a Docker container. No
REBAR_AAL2_ONLY Defaults to false, this should be set to true for the Rebar Admin docker when running as the AAL2 service. No
REBAR_JOBS_START_SERVER Defaults to false, this should be set to true if a listener is to be configured for incoming HTTP requests. Requests will return a 200 HTTP result and nothing else. This is useful in environments like AWS Elastic Beanstalk. No
REBAR_CORE_TYPE When deploying leveraging config files, you will set to the following

API for the Rebar API
ADMIN for the Rebar Admin
JOBS for the Rebar Jobs
No
REBAR_CORE_API The MySql/Aurora connection string API Service. This connection string shall be formatted in the following manner: SslMode=Required;User Id=rebar_web_apis;Password=;Data Source= Initial Catalog=rebar; MinimumPoolSize=5; MaximumPoolSize=1000; Pooling=true; ConnectionLifeTime=30; Convert Zero Datetime=True; No
REBAR_CORE_ADMIN The MySql/Aurora connection string Admin Service. This connection string shall be formatted in the following manner: SslMode=Required;User Id=rebar_web_admn;Password=;Data Source= Initial Catalog=rebar; MinimumPoolSize=5; MaximumPoolSize=1000; Pooling=true; ConnectionLifeTime=30; Convert Zero Datetime=True; No
REBAR_CORE_JOBS The MySql/Aurora connection string Jobs Service. This connection string shall be formatted in the following manner: SslMode=Required;User Id=rebar_web_svcs;Password=;Data Source= Initial Catalog=rebar; MinimumPoolSize=5; MaximumPoolSize=1000; Pooling=true; ConnectionLifeTime=30; Convert Zero Datetime=True; No
REBAR_DB_PASSWORD_API
REBAR_DB_PASSWORD_ADMIN
REBAR_DB_PASSWORD_JOBS

AWS Specfic Configuration Environment Variables

Variable Name Description Name Required
REBAR_AWS Determines if Rebar is deployed in AWS No
REBAR_AWS_CONFIG_BUCKET The AWS S3 Bucket that configuration data will be pulled from. If using the Monkton CloudFormation scripts, this will automatically grant read permissions to the bucket via IAM Roles. If not using the Monkton provided CloudFormation scripts, you must grant read object access to for the service running Rebar. No
REBAR_AWS_CONFIG_REGION The region where the AWS S3 Bucket is located. No
REBAR_AWS_CONFIG_NAME The key that has the extended configuration located in AWS S3. No
REBAR_AWS_AUTO_CONFIG_FILE
REBAR_AWS_CONFIG_SECRET_KEY
REBAR_AWS_CONFIG_ACCESS_KEY
REBAR_AWS_SNS_REGION
REBAR_AWS_SNS_SECRET_KEY
REBAR_AWS_SNS_ACCESS_KEY
REBAR_S3_DATA_PROTECTION
REBAR_S3_DATA_PROTECTION_PREFIX

AWS Specfic Configuration Environment Variables

Variable Name Description Name Required
DOTNET_SYSTEM_NET_HTTP_ USESOCKETSHTTPHANDLER When performing serverless deployment, there maybe issues of TLS connections failing with .NET Core 2.1. Set this value to 0 to switch to the older TLS engine. No

Last Updated: February 02, 2019