How to install Thinkfree Office on Kubernetes

Modified on Fri, Jun 26 at 2:41 PM

This document explains how to install Thinkfree Office in a Kubernetes environment.

It is based on standard customer environments and assumes that the following prerequisites are met:

AWS CLI and Helm must be installed
AWS authentication must be completed using credentials provided by your Thinkfree representative
Kubernetes integration must be completed prior to deployment

If these requirements are not yet fulfilled, please refer to the pre-installation preparation guide.

Install Thinkfree Office

1) Setting variable values

ACCOUNT=958750823146
REGION=ap-northeast-2
SECRET_NAME=thinkfree-office-ecr-secret
TOKEN=`aws ecr get-login-password --region=${REGION}`

SECRET_NAME: You can change it to another name.

2) Create Secret

In order to properly execute the command below, an environment capable of Kubernetes deployment must be configured.

kubectl create secret docker-registry ${SECRET_NAME} \
    --docker-server=https://${ACCOUNT}.dkr.ecr.${REGION}.amazonaws.com \
    --docker-username=AWS \
    --docker-password="${TOKEN}" \

3) Installation

1. AWS Certification

helm registry login --username AWS --password-stdin ${ACCOUNT}.dkr.ecr.${REGION}.amazonaws.com <<< "${TOKEN}"

2. Install Thinkfree Office

helm upgrade --install thinkfree oci://${ACCOUNT}.dkr.ecr.${REGION}. amazonaws.com/thinkfree-office-chart \
 --set image.pullSecrets[0]=${SECRET_NAME}
 --version 2.5.5.1

thinkfree: This is the part corresponding to the Release Name of the Helm Chart. You can change it to a different name.

Thinkfree Office Test

Once the installation is complete, you will see the following message:

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⡿⣟⣿⣻⣿⣻⣟⣿⣟⣿⣻⣿⣳⣦⣄⠀⠀⠀⠀⠀⠀⢠⡰⣜⢮⡫⣏⢯⡫⣏⢯⡫⣏⢯⡫⡯⠀⠀
⠀⠀⣿⣻⣽⣟⣾⣯⢿⣳⣿⣽⢷⣿⣽⢷⣟⣧⡄⠀⠀⢀⢼⢕⣝⢮⡳⡝⣎⢗⣝⢎⣗⢝⣎⢗⣝⢮⠀⠀
⠀⠀⣯⣿⢾⣯⡷⣿⣻⡿⣞⣯⡿⣷⣟⣿⣽⡷⣷⠀⠀⡮⣳⢳⢕⡗⡵⣝⢮⡳⣕⢗⣕⢗⣕⢗⣕⢗⠀⠀
⠀⠀⠈⠈⠁⠁⠉⠈⠈⠈⠁⠁⠉⢿⣾⣻⣾⣻⡿⡅⠨⣺⡪⣳⢳⡹⡕⠁⠁⠈⠈⠈⠀⠁⠈⠈⠀⠁⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⣾⣻⡾⣯⣿⡂⠨⡺⣜⢮⡳⣝⢎⠀⠀⠀⡠⣔⢦⡢⡄⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⣯⣷⢿⣻⣾⡂⠨⡫⡮⣳⡹⣜⢕⠀⠀⡪⣏⢮⡳⡝⡮⡢⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⡷⣟⣿⣯⣷⠅⠨⡳⣝⢮⡺⡪⡇⠀⠀⡫⡮⡳⣝⢮⡫⡎⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⣟⣯⣷⢿⣾⠅⠨⡳⣕⢗⣝⡝⡎⠀⠀⠈⠪⠫⡺⠪⠊⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⣯⡿⣾⢿⣽⠅⠨⣝⢮⢳⢕⢽⡱⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⡷⣿⣻⣿⣽⠅⠨⣺⢪⣫⢳⡳⡕⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⣟⣯⣿⢾⣯⡃⠨⢮⡳⣕⢗⣕⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢽⣯⡿⣾⢿⣽⡂⠨⡳⣝⢼⢕⢧⢇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠽⡷⢿⢻⠿⡽⡂⠨⡳⠵⢝⠮⡳⠣⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

Thank you for installing ThinkfreeOffice.
Please follow the next steps.

1. Get ThinkfreeOffice administrator URL by running these commands:
  export POD_NAME=$(kubectl get pods -l "app=was" -o jsonpath="{.items[0].metadata.name}")
  kubectl port-forward --address 0.0.0.0 $POD_NAME 8070:8070

2. Open the browser and access ThinkfreeOffice administrator page through the following URL:
  (The container initialization process may take some time.)
  http://127.0.0.1:8070/cloud-office

3. Register the license key received on the administrator page.
  ‘License’ > ‘Upgrade License’

4. Enable external integration for testing.
  'External linkage' > Activate the local adapter by clicking 'Run', which is set to 'Stopped'

5. You can access ThinkfreeOffice through the following URL:
  * Word Processor
  http://127.0.0.1:8070/cloud-office/api/local/sample.docx/open?app=WRITE_EDITOR&user_id=username&docId=tfoword

  * Spreadsheet
  http://127.0.0.1:8070/cloud-office/api/local/sample.xlsx/open?app=CALC_EDITOR&user_id=username&docId=tfocell

  * Presentation
  http://127.0.0.1:8070/cloud-office/api/local/sample.pptx/open?app=SHOW_EDITOR&user_id=username&docId=tfoshow

  * PDF
  http://127.0.0.1:8070/cloud-office/api/local/sample.pdf/open?app=PDF_VIEWER&user_id=username&docId=tfopdf

Port forward to port 8070 to allow access to the end-point URL.
- export POD_NAME=$(kubectl get pods -l "app=was" -o jsonpath="{.items[0].metadata.name}")
  kubectl port-forward --address 0.0.0.0 $POD_NAME 8070:8070
Access the ThinkfreeOffice administrator page.
- http://127.0.0.1:8070/cloud-office
Register the license key.
Activate the adapter for testing.
- 'External Integration' → Activate the adapter named 'local' by pressing the “Run” button.
Open a web browser and enter the following URL to proceed with the test.

Next, set up Helm Chart for Thinkfree Office by following the guide here.