Skip to content

Commit 8564ca9

Browse files
authored
Merge branch 'main' into ngf/include-ports-helm-kind
2 parents f03289f + d6cfafa commit 8564ca9

File tree

2 files changed

+74
-1
lines changed

2 files changed

+74
-1
lines changed

content/nim/fundamentals/tech-specs.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,28 @@ You can deploy NGINX Instance Manager in the following environments:
2424

2525
{{< include "nim/tech-specs/supported-distros.md" >}}
2626

27+
## Supported NGINX Instance Manager versions {#supported-nginx-instance-manager-versions}
28+
29+
We recommend using the latest release of NGINX Instance Manager, and provides software updates for the most recent release.
30+
31+
We provide technical support for F5 customers who are using the most recent version of NGINX Instance Manager, and any version released within two years of the current release.
32+
33+
NGINX Instance Manager supports the following versions :
34+
35+
36+
37+
| Nginx Instance Manager Version | End of Technical Support |
38+
|----------------------------------|---------------------------------------------------|
39+
| 2.21.x | Nov 07, 2027 |
40+
| 2.20.x | Jun 15, 2027 |
41+
| 2.19.x | Feb 06 10, 2026 |
42+
| 2.18.x | Jul 10, 2026 |
43+
| 2.17.x | Nov 08, 2026 |
44+
| 2.16.x | Apr 16, 2026 |
45+
| 2.15.x | Dec 13, 2025 |
46+
47+
48+
2749
## Supported NGINX Versions {#nginx-versions}
2850

2951
{{< include "nim/tech-specs/supported-nginx-versions.md" >}}

content/nim/waf-integration/configuration/install-waf-compiler/install-disconnected.md

Lines changed: 52 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Earlier releases used 4.x.x for VM packages (for example, NAP 4.15.0, NAP 4.16.0
2929

3030
---
3131

32-
## Install the WAF compiler by distribution
32+
## Install the WAF compiler on Virtual machine or baremetal
3333

3434
{{< tabs name="install-waf-compiler-offline" >}}
3535

@@ -206,3 +206,54 @@ Earlier releases used 4.x.x for VM packages (for example, NAP 4.15.0, NAP 4.16.0
206206
{{% /tab %}}
207207
208208
{{< /tabs >}}
209+
210+
## Install the WAF compiler in Kubernetes
211+
212+
**On a system with internet access:**
213+
214+
Build the following Dockerfile by updating the base image version and target compiler version as per your requirement. Here , in this example, we've used NIM version as latest 2.21.0 ( Which comes with WAF compiler v5.527.0) and additional WAF compiler to be installed as v5.550.0.
215+
216+
```shell
217+
FROM private-registry.nginx.com/nms/integrations:2.21.0
218+
# switch back to root so apt works
219+
USER root
220+
ARG NMS_NAP_COMPILER_VERSION=5.550.0
221+
ENV NMS_NAP_COMPILER_PACKAGE=nms-nap-compiler-v${NMS_NAP_COMPILER_VERSION}
222+
223+
# Install the additional target compiler from NGINX private repository
224+
RUN --mount=type=secret,id=nginx-crt,dst=/etc/ssl/nginx/nginx-repo.crt,mode=0644 \
225+
--mount=type=secret,id=nginx-key,dst=/etc/ssl/nginx/nginx-repo.key,mode=0644 \
226+
wget -qO - https://nginx.org/keys/nginx_signing.key | gpg --dearmor | \
227+
tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null \
228+
&& gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg \
229+
&& printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/nms/ubuntu `lsb_release -cs` nginx-plus\n" | tee /etc/apt/sources.list.d/nim.list \
230+
&& wget -P /etc/apt/apt.conf.d https://cs.nginx.com/static/files/90pkgs-nginx \
231+
&& apt-get update \
232+
&& DEBIAN_FRONTEND="noninteractive" apt-get install -y ${NMS_NAP_COMPILER_PACKAGE} -o Dpkg::Options::="--force-overwrite" \
233+
&& apt-get clean \
234+
&& rm -rf /var/lib/apt/lists/* /etc/apt/sources.list.d/nim.list \
235+
&& rm -rf /etc/apt/apt.conf.d/90nginx
236+
237+
# drop privileges again
238+
USER nms
239+
CMD ["sh", "-c", "update-ca-certificates && /usr/bin/nms-integrations"]
240+
```
241+
242+
Build the compiler
243+
244+
```shell
245+
docker build --no-cache --platform linux/amd64 --secret id=nginx-crt,src=/path/to/nginx-repo.crt,type=file --secret id=nginx-key,src=/path/to/nginx-repo.key,type=file -t integrations:waf-compiler-extended .
246+
```
247+
248+
Move the yielded docker image to the target offline system.
249+
250+
**On the offline target system:**
251+
252+
Host the docker image on either local or remote registry.
253+
Edit the kubernetes deployment w.r.t integrations to reference to the new docker image hosted.
254+
255+
```shell
256+
kubectl edit deploy -n <namespace> integrations
257+
```
258+
Once the pod comes up with the latest image, system should be up with both the compiler installed and should be able to compile policies on datapath's having either versions of WAF.
259+

0 commit comments

Comments
 (0)