Batch Poster in AWS Nitro

This tool enables the creation of an Enclave Image File (EIF) from a specified Nitro Node image for use in AWS Nitro Enclaves. By providing the SHA256 hash of the configuration and specifying the Nitro image, the tool generates a Dockerfile incorporating the resulting EIF file. This process, facilitated by Enclaver, will provide network connectivity between our enclave and the outside world. The layout of the repository is as follows:

• docker: Contains the Dockerfile that pulls the Nitro Node image and configures a Docker image, which is then converted into an Enclave Image File (EIF).
• enclaver: Configuration for the Enclaver tool, generating a Docker image that includes the EIF file.
• scripts: Includes scripts to install, and run the tools needed on the parent EC2 instance, preparing it to run and communicate with the Batch Poster within the enclave.

Workflow Prerequisites

To run this workflow you need the latest nitro image tag as well as the sha256 hash of the batch poster config. To get the hash of the batch poster config run:

jq -cS . "path/to/poster_config.json" | sha256sum | cut -d' ' -f1

Scripts

To run the scripts you can clone this repository and cd into scripts directory:

cd aws-nitro/scripts

Next install the tools needed on the parent instance:

./installation-tools.sh

Then you can setup and run the tools needed on the EC2 Instance by running:

./setup-ec2-instance.sh

Finally you can start the enclaver by using the docker compose file found in docker folder:

docker pull ghcr.io/espressosystems/aws-nitro-poster:<created-docker-tag>
docker compose up -d

To safely shut down the batch poster and ensure we write state to the database you need to use the following command:

./shutdown-batch-poster.sh