Docker Image for Form 3922
These instructions assume you are familiar with Docker technology
including deploying Docker containers as microservices.
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
Download the image to your computer
docker pull us-central1-docker.pkg.dev/taxdochub-endpoints/tax-doc-server-tax3922/tax3922-generator:latest
Run the Docker app on your computer
docker run --publish 8080:8080 us-central1-docker.pkg.dev/taxdochub-endpoints/tax-doc-server-tax3922/tax3922-generator:latest
Produce a sample PDF form.
Open a browser window and enter the below URL
https://localhost:8080/sample
POST JSON to the microservice
POST TaxDataList object as application/json. Download sample JSON
Accept application/pdf
Example IntelliJ .http file
POST http://localhost:8080/fdx/v5/tax-forms Content-Type: application/json Accept: application/pdf < Tax3922.TaxDataList.fdx.json
Example curl command
curl -X POST --location "http://localhost:8080/fdx/v5/tax-forms" \ -H "Content-Type: application/json" \ -H "Accept: application/pdf" \ -d Tax3922.TaxDataList.fdx.json
Build and Deploy Container
Follow the procedures applicable to your server hosting service.