chore: Refactored icon usage to use new shortcode

Author: lamATnginx

_banners/agent-v3-release.md

@@ -1,7 +1,8 @@
 {{< banner "notice" "NGINX Agent 3.0 is now available" >}}
 
+The documentation in this section is for **NGINX Agent version 2.x**. For NGINX Agent 3.x content visit the [NGINX One Console documentation]({{< ref "/nginx-one/agent/" >}})
 
-F5 NGINX One Console and NGINX Instance Manager (NIM) do not currently support Agent 3.x. If you are using NGINX One Console or NGINX Instance Manager in your environment, upgrade to the latest Agent 2.x version by following the [Upgrade NGINX Agent](/nginx-agent/installation-upgrade/upgrade/) guide.
+F5 NGINX Instance Manager (NIM) does not currently support NGINX Agent 3.x. NGINX Instance Manager customers can upgrade to the latest NGINX Agent 2.x version by following the [Upgrade NGINX Agent](/nginx-agent/installation-upgrade/upgrade/) guide.
 
 Please see the [Technical specifications](/nginx-agent/technical-specifications/) for product compatibility.
 

content/includes/agent/about.md

@@ -40,4 +40,4 @@ Additionally, it collects system-level data, including CPU usage, memory consump
 deep observability into NGINX's behavior, enabling teams to troubleshoot issues effectively, optimize performance, and
 maintain high availability.
 
-Collected metrics can be seamlessly exported to NGINX One Console or integrated with third-party data aggregators.
+By default, the OpenTelemetry Collector is configured to send metrics to NGINX One Console.

content/nginx-one/agent/containers/run-agent-container.md

@@ -29,13 +29,10 @@ container image and create a configuration file.
 
 ### Pull the NGINX Agent container image
 
-The NGINX Agent container image must be downloaded from a trusted source such as Docker Hub or a private container registry.
-
 Run the following command to pull the official image:
 
 ```bash
-<!-- Registry HERE -->
-docker pull <Registry HERE>:latest
+docker pull private-registry.nginx.com/nginx-plus/agentv3:latest
 ```
 
 Ensure you are using the correct image version. Replace `latest` with the desired version tag if necessary.

content/nginx-one/agent/install-upgrade/install-from-oss-repo.md

@@ -30,7 +30,7 @@ up the `nginx-agent` packages repository. Afterward, you can install and update
 NGINX Agent from the repository.
 
 <details>
-<summary>{{< icon "brands fa-centos" >}} Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
+<summary>{{< icon "brands centos" >}} Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
 
 ### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
 
@@ -39,7 +39,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-ubuntu" >}} Install NGINX Agent on Ubuntu</summary>
+<summary>{{< icon "brands ubuntu" >}} Install NGINX Agent on Ubuntu</summary>
 
 ### Install NGINX Agent on Ubuntu
 
@@ -48,7 +48,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-debian" >}} Install NGINX Agent on Debian</summary>
+<summary>{{< icon "brands debian" >}} Install NGINX Agent on Debian</summary>
 
 ### Install NGINX Agent on Debian
 
@@ -57,7 +57,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-suse" >}} Install NGINX Agent on SLES</summary>
+<summary>{{< icon "brands suse" >}} Install NGINX Agent on SLES</summary>
 
 ### Install NGINX Agent on SLES
 
@@ -66,7 +66,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "solid fa-mountain-sun" >}} Install NGINX Agent on Alpine Linux</summary>
+<summary>{{< icon "brands alpine" >}} Install NGINX Agent on Alpine Linux</summary>
 
 ### Install NGINX Agent on Alpine Linux
 
@@ -75,15 +75,15 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-aws" >}} Install NGINX Agent on Amazon Linux</summary>
+<summary>{{< icon "brands aws" >}} Install NGINX Agent on Amazon Linux</summary>
 
 ### Install NGINX Agent on Amazon Linux
 
 {{< include "/agent/installation/oss/oss-amazon-linux.md" >}}
 
 </details>
 <details>
-<summary>{{< icon "brands fa-freebsd" >}} Install NGINX Agent on FreeBSD</summary>
+<summary>{{< icon "brands freebsd" >}} Install NGINX Agent on FreeBSD</summary>
 
 ### Install NGINX Agent on FreeBSD
 

content/nginx-one/agent/install-upgrade/install-from-plus-repo.md

@@ -31,7 +31,7 @@ NGINX Agent from the repository.
 
 
 <details>
-<summary>{{< icon "brands fa-centos" >}} Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
+<summary>{{< icon "brands centos" >}} Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
 
 ### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux<a name="install-nginx-agent-on-rhel-centos-rocky-linux-almalinux-and-oracle-linux-plus"></a>
 
@@ -40,7 +40,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-ubuntu" >}} Install NGINX Agent on Ubuntu</summary>
+<summary>{{< icon "brands ubuntu" >}} Install NGINX Agent on Ubuntu</summary>
 
 ### Install NGINX Agent on Ubuntu<a name="install-nginx-agent-on-ubuntu-plus"></a>
 
@@ -49,7 +49,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-debian" >}} Install NGINX Agent on Debian</summary>
+<summary>{{< icon "brands debian" >}} Install NGINX Agent on Debian</summary>
 
 ### Install NGINX Agent on Debian<a name="install-nginx-agent-on-debian-plus"></a>
 
@@ -58,7 +58,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-suse" >}} Install NGINX Agent on SLES</summary>
+<summary>{{< icon "brands suse" >}} Install NGINX Agent on SLES</summary>
 
 ### Install NGINX Agent on SLES<a name="install-nginx-agent-on-sles-plus"></a>
 
@@ -67,15 +67,15 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "solid fa-mountain-sun" >}} Install NGINX Agent on Alpine Linux</summary>
+<summary>{{< icon "brands alpine" >}} Install NGINX Agent on Alpine Linux</summary>
 
 ### Install NGINX Agent on Alpine Linux<a name="install-nginx-agent-on-alpine-linux-plus"></a>
 
 {{< include "/agent/installation/plus/plus-alpine.md" >}}
 
 </details>
 <details>
-<summary>{{< icon "brands fa-aws" >}} Install NGINX Agent on Amazon Linux</summary>
+<summary>{{< icon "brands aws" >}} Install NGINX Agent on Amazon Linux</summary>
 
 ### Install NGINX Agent on Amazon Linux<a name="install-nginx-agent-on-amazon-linux-plus"></a>
 
@@ -84,7 +84,7 @@ NGINX Agent from the repository.
 </details>
 
 <details>
-<summary>{{< icon "brands fa-freebsd" >}} Install NGINX Agent on FreeBSD</summary>
+<summary>{{< icon "brands freebsd" >}} Install NGINX Agent on FreeBSD</summary>
 
 ### Install NGINX Agent on FreeBSD<a name="install-nginx-agent-on-freebsd-plus"></a>
 

content/nginx-one/agent/install-upgrade/uninstall.md

@@ -19,7 +19,7 @@ The user following performing the uninstall steps needs to have `root` privilege
 Complete the following steps on each host where you've installed NGINX Agent
 
 <details>
-<summary>{{< icon "brands fa-centos" >}} Uninstall NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
+<summary>{{< icon "brands centos" >}} Uninstall NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
 
 ### Uninstall NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
 
@@ -28,7 +28,7 @@ Complete the following steps on each host where you've installed NGINX Agent
 </details>
 
 <details>
-<summary>{{< icon "brands fa-ubuntu" >}} Uninstall NGINX Agent on Ubuntu</summary>
+<summary>{{< icon "brands ubuntu" >}} Uninstall NGINX Agent on Ubuntu</summary>
 
 ### Uninstall NGINX Agent on Ubuntu
 
@@ -37,7 +37,7 @@ Complete the following steps on each host where you've installed NGINX Agent
 </details>
 
 <details>
-<summary>{{< icon "brands fa-debian" >}} Uninstall NGINX Agent on Debian</summary>
+<summary>{{< icon "brands debian" >}} Uninstall NGINX Agent on Debian</summary>
 
 ### Uninstall NGINX Agent on Debian
 
@@ -46,7 +46,7 @@ Complete the following steps on each host where you've installed NGINX Agent
 </details>
 
 <details>
-<summary>{{< icon "brands fa-suse" >}} Uninstall NGINX Agent on SLES</summary>
+<summary>{{< icon "brands suse" >}} Uninstall NGINX Agent on SLES</summary>
 
 ### Uninstall NGINX Agent on SLES
 
@@ -55,7 +55,7 @@ Complete the following steps on each host where you've installed NGINX Agent
 </details>
 
 <details>
-<summary>{{< icon "solid fa-mountain-sun" >}} Uninstall NGINX Agent on Alpine Linux</summary>
+<summary>{{< icon "brands alpine" >}} Uninstall NGINX Agent on Alpine Linux</summary>
 
 ### Uninstall NGINX Agent on Alpine Linux
 
@@ -64,7 +64,7 @@ Complete the following steps on each host where you've installed NGINX Agent
 </details>
 
 <details>
-<summary>{{< icon "brands fa-aws" >}} Uninstall NGINX Agent on Amazon Linux</summary>
+<summary>{{< icon "brands aws" >}} Uninstall NGINX Agent on Amazon Linux</summary>
 
 ### Uninstall NGINX Agent on Amazon Linux
 
@@ -73,7 +73,7 @@ Complete the following steps on each host where you've installed NGINX Agent
 </details>
 
 <details>
-<summary>{{< icon "brands fa-freebsd" >}} Uninstall NGINX Agent on FreeBSD</summary>
+<summary>{{< icon "brands freebsd" >}} Uninstall NGINX Agent on FreeBSD</summary>
 
 ### Uninstall NGINX Agent on FreeBSD
 

content/nginx-one/connect-instances/connect-nginx-plus-container-images-to-nginx-one.md

@@ -42,13 +42,13 @@ sudo docker login private-registry.nginx.com --username=YOUR_JWT_HERE --password
 
 ### Pull the NGINX Plus image
 
-Pull the NGINX Plus image from the private registry. Replace `VERSION_TAG` with the desired version, such as `alpine`, `debian`, or `ubi`.
+Pull the NGINX Plus image from the private registry. Replace `<version-tag>` with the desired version, such as `alpine`, `debian`, or `ubi`.
 
 ```sh
-sudo docker pull private-registry.nginx.com/nginx-plus/agent:VERSION_TAG
+docker pull private-registry.nginx.com/nginx-plus/agentv3:<version-tag>
 ```
 
-You must specify a version tag. The `latest` tag is not supported. Learn more in the [Deploying NGINX and NGINX Plus on Docker]({{< ref "/nginx/admin-guide/installing-nginx/installing-nginx-docker.md#pull-the-image" >}}) guide.
+You must specify a version tag that matches your distribution. The `latest` tag is not supported. Learn more in the [Deploying NGINX and NGINX Plus on Docker]({{< ref "/nginx/admin-guide/installing-nginx/installing-nginx-docker.md#pull-the-image" >}}) guide.
 
 <br>
 
@@ -62,7 +62,7 @@ sudo docker pull private-registry.nginx.com/nginx-plus/agent:debian
 
 ### Start the NGINX Plus container
 
-Start the Docker container to connect it to NGINX One. Replace `YOUR_NGINX_ONE_DATA_PLANE_KEY_HERE` with your data plane key and `VERSION_TAG` with the version tag you pulled.
+Start the Docker container to connect it to NGINX One. Replace `YOUR_NGINX_ONE_DATA_PLANE_KEY_HERE` with your data plane key and `version-tag` with the version tag you pulled.
 
 **For NGINX Plus R33 or later**:
 
@@ -79,7 +79,7 @@ sudo docker run \
 --env=NGINX_AGENT_TLS_ENABLE=true \
 --restart=always \
 --runtime=runc \
--d private-registry.nginx.com/nginx-plus/agent:<VERSION_TAG>
+-d private-registry.nginx.com/nginx-plus/agent:<version-tag>
 ```
 
 <br>

content/nginx-one/nginx-configs/config-sync-groups/manage-config-sync-groups.md

@@ -162,14 +162,9 @@ When adding a new NGINX instance that is not yet registered with NGINX One, you
    - From the **OS Type** list, choose the appropriate operating system for your Docker image.
    - After selecting the OS, run the provided command to pull the Docker image.
 
-   **Note**: Subject to availability, you can modify the `agent: <VERSION_TAG>` to match the specific NGINX Plus version, OS type, and OS version you need. For example, you might use `agent: r32-ubi-9`. For more details on version tags and how to pull an image, see [Deploying NGINX and NGINX Plus on Docker]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-docker.md#pull-the-image" >}}).
+   **Note**: Subject to availability, you can modify the `agentv3:<version-tag>` to match the specific NGINX Plus version, OS type, and OS version you need. For example, you might use `agentv3:r32-ubi-9`. For more details on version tags and how to pull an image, see [Deploying NGINX and NGINX Plus on Docker]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-docker.md#pull-the-image" >}}).
 
 
-   - From the **OS Type** list, choose the appropriate operating system for your Docker image.
-   - After selecting the OS, run the provided command to pull the Docker image.
-
-   **Note**: Subject to availability, you can modify the `agent: <VERSION_TAG>` to match the specific NGINX Plus version, OS type, and OS version you need. For example, you might use `agent: r32-ubi-9`. For more details on version tags and how to pull an image, see [Deploying NGINX and NGINX Plus on Docker]({{< ref "nginx/admin-guide/installing-nginx/installing-nginx-docker.md#pull-the-image" >}}).
-
 10. Run the provided command, which includes the data plane key, in your NGINX instance terminal to start the Docker container.
 
 11. Select **Done** to complete the process.

content/nginx/admin-guide/installing-nginx/installing-nginx-docker.md

@@ -156,24 +156,36 @@ For NGINX Plus, run:
 docker pull private-registry.nginx.com/nginx-plus/base:<version-tag>
 ```
 
-For NGINX Plus with NGINX Agent, run:
+For NGINX Plus with NGINX Agent version 2, run:
 
 ```shell
 docker pull private-registry.nginx.com/nginx-plus/agent:<version-tag>
 ```
 
+For NGINX Plus with NGINX Agent version 3, run:
+
+```shell
+docker pull private-registry.nginx.com/nginx-plus/agentv3:<version-tag>
+```
+
 For NGINX Plus installed from `nginx` user (rootless installation), run:
 
 ```shell
 docker pull private-registry.nginx.com/nginx-plus/rootless-base:<version-tag>
 ```
 
-For NGINX Plus with NGINX Agent installed from `nginx` user (rootless installation), run:
+For NGINX Plus with NGINX Agent version 2 installed from `nginx` user (rootless installation), run:
 
 ```shell
 docker pull private-registry.nginx.com/nginx-plus/rootless-agent:<version-tag>
 ```
 
+For NGINX Plus with NGINX Agent version 3 installed from `nginx` user (rootless installation), run:
+
+```shell
+docker pull private-registry.nginx.com/nginx-plus/rootless-agentv3:<version-tag>
+```
+
 For NGINX modules, run:<!-- Is this enough info?-->
 
 ```shell

content/nic/configuration/policy-resource.md

@@ -175,8 +175,14 @@ condition:
 |Field | Description | Type | Required |
 | ---| ---| ---| --- |
 |``jwt`` | defines a JWT condition to rate limit against. | [ratelimit.condition.jwt](#ratelimitconditionjwt) | No |
-|``default`` | sets the rate limit in this policy to be the default if no conditions are met. In a group of policies with the same JWT condition, only one policy can be the default. | ``bool`` | No |
+|``variables`` | defines a Variable condition to rate limit against. | [ratelimit.condition.variables](#ratelimitconditionvariables) | No |
+|``default`` | sets the rate limit in this policy to be the default if no conditions are met. In a group of policies with the same condition, only one policy can be the default. | ``bool`` | No |
 {{% /table %}}
+{{< note >}}
+ 
+One condition of type `jwt` or `variables` is required. Each Policy supports only one condition.
+
+{{< /note >}}
 
 The rate limit policy with condition is designed to be used in combination with one or more rate limit policies. For example, multiple rate limit policies with [RateLimit.Condition.JWT](#ratelimitconditionjwt) can be used to apply different tiers of rate limit based on the value of a JWT claim. For a practical example of tiered rate limiting by the value of a JWT claim, see the example in our [GitHub repository](https://github.com/nginx/kubernetes-ingress/tree/v{{< nic-version >}}/examples/custom-resources/rate-limit-tiered-jwt-claim/README.md).
 
@@ -213,6 +219,27 @@ The rate limit policy will only apply to requests that contain a JWT with the sp
 |``match`` | the value of the claim to match against. | ``string`` | Yes |
 {{% /table %}}
 
+### RateLimit.Condition.Variables
+
+RateLimit.Condition.Variables defines a condition for a rate limit by NGINX variable. The following example defines a condition for a rate limit policy that only applies to requests with the request method with a value `GET`:
+
+```yaml
+variables:
+  - name: $request_method
+    match: GET
+```
+
+{{< note >}}
+Only one variable at a time is supported at present.
+{{< /note >}}
+
+{{% table %}}
+|Field | Description | Type | Required |
+| ---| ---| ---| --- |
+|``name`` | the name of the NGINX variable to be rate limit by. | ``string`` | Yes |
+|``match`` | the value of the NGINX variable to match against.  Values prefixed with the `~` character denote the following is a [regular expression](https://nginx.org/en/docs/http/ngx_http_map_module.html#map).  | ``string`` | Yes |
+{{% /table %}}
+
 ### APIKey
 
 The API Key auth policy configures NGINX to authorize client requests based on the presence of a valid API Key in a header or query param specified in the policy.