The HTC-Grid project has external software dependencies that are deployed as container images. Instead of downloading each time from external repositories like the public DockerHub repository, this step will pull those dependencies and upload them into the your Amazon Elastic Container Registry (ECR).
HTC-Grid uses a few open source project with container images stored at Dockerhub. Dockerhub has a download rate limit policy. This may impact you when running this step as an anonymous user as you can get errors when running the terraform command below. To overcome those errors, you can re-run the terraform command and wait until the throttling limit is lifted, or optionally you can create an account in hub.docker.com and then use the credentials of the account using docker login locally to avoid anonymous throttling limitations.
As you’ll be uploading images to ECR, to avoid timeouts, refresh your ECR authentication token:
Go into the terraform image deployment directory. This contains the terraform project that will help to create a copy of the required images to your ECR repository. The following command will go to the
~/environment/aws-htc-grid/deployment/image_repository/terraform and initialize the terraform project using the bucket
$S3_IMAGE_TFSTATE_HTCGRID_BUCKET_NAME as the bucket that will hold the terraform state:
make init-images TAG=$TAG REGION=$HTCGRID_REGION
If successful, you can now run terraform apply to create the HTC-Grid infrastructure. This can take between 10 and 15 minutes depending on the Internet connection.
make transfer-images TAG=$TAG REGION=$HTCGRID_REGION
The execution of this command will prompt for
yes to continue. Just type yes, for the command to proceed
This operation fetches images from external repositories and creates a copy into your ECR account, sometimes the fetch to external repositories may have temporary failures due to the state of the external repositories, If the
terraform apply fails with errors such as
name unknown: The repository with name 'xxxxxxxxx' does not exist in the registry with id, re-run the command until the
terraform apply step successfully completes.
The following command will list the repositories You can check which repositories have been created in the ECR console or by executing the command :
aws ecr describe-repositories --region $HTCGRID_REGION --query "repositories[*].repositoryUri"
transfer-images command builds and stores your runtime images locally and then pushes those to the ECR repository. Unless there are major changes to the Dockerfile, any consequitive runs of this command will re-use the cache.
To enforce a rebuild of the runetime images locally and also push them to ECR, the above command can be customized as below:
make transfer-images TAG=$TAG REGION=$HTCGRID_REGION REBUILD_RUNTIMES=true