Docker Image for Form 1099-SB

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-tax1099sb/tax1099sb-generator:latest

3. Start the Docker app on your computer or server

share=/Users/yourname/docker-share

docker run --detach --interactive --tty \
--name tax1099sb-generator-latest \
--publish 8080:8080 \
--platform linux/amd64 \
--volume ${share}:/var/shared-folder \
us-central1-docker.pkg.dev/taxdochub-endpoints/tax-doc-server-tax1099sb/tax1099sb-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
< Tax1099Sb.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 Tax1099Sb.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/Tax1099Sb 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