Docker Image for Form 3921

These instructions assume you are familiar with Docker technology
including deploying Docker containers as microservices.

Microservice

1. Install Google Cloud Command Line Tool (gcloud CLI)

See One-Time Authorization Set Up below.

2. Download the image to your computer or server

docker pull us-central1-docker.pkg.dev/taxdochub-endpoints/tax-doc-server-tax3921/tax3921-generator:latest

3. Start the Docker app on your computer or server

share=/Users/yourname/docker-share

docker run --detach --interactive --tty \
--name tax3921-generator-latest \
--publish 8080:8080 \
--platform linux/amd64 \
--volume ${share}:/var/shared-folder \
us-central1-docker.pkg.dev/taxdochub-endpoints/tax-doc-server-tax3921/tax3921-generator:latest

4. Using your preferred browser, go the web application at http://localhost:8080. See the user interface and instructions.

5. Individual PDFs: POST JSON to the microservice

POST TaxStatement object as application/json.
Accept application/pdf

Example IntelliJ .http file

POST http://localhost:8080/fdx/v6/tax-forms
Content-Type: application/json
Accept: application/pdf
< Tax3921.json

Example curl command

curl --request POST --location "http://localhost:8080/fdx/v6/tax-forms" \
     --header "Content-Type: application/json" \
     --header "Accept: application/pdf" \
     --data Tax3921.json

6. Batch PDF Production: POST CSV or XLSX file

See upload (POST multipart) instructions in the app
See results in /Users/yourname/docker-share/Tax3921 folder

One-Time Authorization Setup

The docker application (image) is hosted at Google Artifact Registry.

Upon purchase of a license to the docker image, we will grant permission to a google account of your naming to the access the artifact.

It will be necessary for you to do a one-time set-up to install the applicable Google credentials into Docker. There are 2 methods.

Method 1: Use the Google Command Line (gcloud) App.

If you have not installed 'gcloud' previously, see cloud.google.com/sdk/docs/install for installation instructions.

After installing the gcloud program, from a command prompt, run this command:

gcloud init

Then run this command

gcloud auth configure-docker us-central1-docker.pkg.dev

This will provide docker the needed credential helper.

Method 2: Use the Google Docker credential helper

This method can be used if you sign in to Docker with a Google account.

Go to https://github.com/GoogleCloudPlatform/docker-credential-gcr/releases and download the file applicable to your system.

Unzip the archive file and place the helper app somewhere in the path on your computer.

From a command prompt, run this command

docker-credential-gcr configure-docker --registries=us-central1-docker.pkg.dev

The credentials are saved in '.docker/config.json' your user home directory.

For more detailed instructions, see https://cloud.google.com/artifact-registry/docs/docker/authentication