bc-serverservice AWS

This is a status service that stores job status in AWS DynamoDB, and job output in AWS S3.

Environment variables

BEYONDCRON_STATUS_SERVICE AWS
AWS_CONFIG Name of a configuration file containing AWS status service configuration variables. If not an absolute file name, BeyondCron will search BEYONDCRON_DIR_CONFIG , the directory in which bc-server was started, and ~/.AWS_CONFIG for this file for this file. Default is aws.dat
AWS_ACCESS_KEY_ID AWS access key ID. Default is derived by the default credential provider chain.
AWS_SECRET_ACCESS_KEY AWS access key secret. Default is derived by the default credential provider chain.
AWS_REGION AWS region. Default is the derived by the default region provider chain.

Configuration variables

The following configuration variables can be defined within the AWS_CONFIG file, or as environment variables.

AWS_ENDPOINT_DYNAMODB DynamoDB endpoint. Default is https endpoint in AWS_REGION.
AWS_ENDPOINT_S3 S3 endpoint. If the endpoint is not within the domain amazonaws.com, then chunked encoding will be disabled, for compatibility will with Fake S3. Default is https endpoint in AWS_REGION.
AWS_TABLE_CURRENT Name of DynamoDB containing the current status of each job. Default is beyondcron-status.
AWS_TABLE_CURRENT_READ_CAPACITY The read capacity of AWS_TABLE_CURRENT. Default is 5.
AWS_TABLE_CURRENT_WRITE_CAPACITY The write capacity of AWS_TABLE_CURRENT. Default is 5.
AWS_TABLE_HISTORY Name of DynamoDB containing the each jobs status history. Default is beyondcron-status-history.
AWS_TABLE_HISTORY_READ_CAPACITY The read capacity of AWS_TABLE_HISTORY. Default is 5.
AWS_TABLE_HISTORY_WRITE_CAPACITY The write capacity of AWS_TABLE_HISTORY. Default is 5.
AWS_S3_BUCKET The S3 bucket containing the output of each job.
AWS_S3_OBJECT_PREFIX The prefix to use when naming output objects. Default is beyondcron/status/output.

DynamoDB tables

This service requires the following tables:

Table Partition key Sort key Required permissions
AWS_TABLE_CURRENT name (String) Read/Write
AWS_TABLE_HISTORY name (String) timestamp (Number) Read/Write

If the AWS_ACCESS_KEY_ID account has permission, BeyondCron will create these tables if they do not already exist.

S3 Bucket

This service requires the following bucket.

Bucket Required permissions
AWS_S3_BUCKET Read/Write

If the AWS_ACCESS_KEY_ID account has permission, BeyondCron will create the bucket if it does not already exist.

See also

  • service status JDBC

Reference