Skip to content

Commit 44c1273

Browse files
Improve documentation around running using EKS IRSA
1 parent 8b49dca commit 44c1273

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/getting_started.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,8 @@ docker run --env-file ./settings --publish 80:8080 --name nginx-s3-gateway \
159159
nginx-s3-gateway:unprivileged-oss
160160
```
161161

162+
It is worth noting that due to the way the startup scripts work, even the unprivileged container will not work with a read-only root filesystem or a specific uid/gid set other then the default of `101`.
163+
162164
### Building the NGINX Plus Container Image
163165

164166
In order to build the NGINX Plus container image, copy your NGINX Plus
@@ -297,6 +299,7 @@ If you are planning to use the container image on an EKS cluster, you can use a
297299
- As soon as the pods/deployments are updated, you will see the couple of Env Variables listed below in the pods.
298300
- `AWS_ROLE_ARN` - Contains IAM Role ARN
299301
- `AWS_WEB_IDENTITY_TOKEN_FILE` - Contains the token which will be used to create temporary credentials using AWS Security Token Service.
302+
- You must also set the `AWS_REGION` and `JS_TRUSTED_CERT_PATH` environment variables as shown below in addition to the normal environment variables listed in the Configuration section.
300303

301304
The following is a minimal set of resources to deploy:
302305
```yaml
@@ -341,12 +344,17 @@ spec:
341344
value: "virtual"
342345
- name: S3_REGION
343346
value: "<aws region>"
347+
- name: AWS_REGION
348+
value: "<aws region>"
344349
- name: AWS_SIGS_VERSION
345350
value: "4"
346351
- name: ALLOW_DIRECTORY_LIST
347352
value: "false"
348353
- name: PROVIDE_INDEX_PAGE
349354
value: "false"
355+
- name: JS_TRUSTED_CERT_PATH
356+
value: "/etc/ssl/certs/Amazon_Root_CA_1.pem"
357+
350358
ports:
351359
- name: http
352360
containerPort: 80

0 commit comments

Comments
 (0)