--- schema_version: "1" id: 6a6bfe2b050523a1bdd764a8a083bc0c27545b416e59f9c2acf9e474d1203204 title: Installing Runtime Fabric Using Helm collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/runtime-fabric/2.7/install-helm.md canonical_url: https://docs.mulesoft.com/runtime-fabric/2.7/install-helm source_site: docs.mulesoft.com content_type: documentation content_hash: b6f9202c791f7a934f6c5c80236b03a5cc4fd928fd37b418b338d45bccc652f6 description: MuleSoft Documentation Site release: "2.7" latest: false --- --- product: Runtime Fabric version: 2.7 --- # Installing Runtime Fabric Using Helm > For the full documentation index, see: https://docs.mulesoft.com/llms.txt You can use Helm to install Anypoint Runtime Fabric on an Amazon Elastic Kubernetes Service (Amazon EKS), Amazon Elastic Kubernetes Service Anywhere (Amazon EKS-A), Azure Kubernetes Service (AKS), Alibaba Cloud Container Service for Kubernetes (ACK), Google Kubernetes Engine (GKE), Rancher Kubernetes Engine (RKE) or VMware Tanzu Kubernetes Grid installation that you manage. ## Steps to Install Runtime Fabric Using Helm When you use Helm to install Runtime Fabric, you: 1. Create a Runtime Fabric using Runtime Manager 2. Create the `rtf` namespace for Runtime Fabric 3. Create a Docker pull secret for pulling the Runtime Fabric component images 4. Optionally, configure additional authorized namespaces 5. Add the Runtime Fabric Helm repository 6. Download the `values.yml` file and install Runtime Fabric 7. Complete install steps ## Before you Begin Before installing Anypoint Runtime Fabric in a Kubernetes environment, ensure that you have: - Reviewed the architecture and requirements outlined in the [Runtime Fabric Overview](https://docs.mulesoft.com/runtime-fabric/2.7/). - [Configured your network to support Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/install-self-managed-network-configuration). - Installed and configured your Kubernetes environment as follows: - Running an ACK, AKS, EKS, EKS-A, GKE, RKE, or VMware Tanzu Kubernetes environment. Other Kubernetes environments are not supported. - Running a supported Kubernetes version. - Running an ingress controller to send external requests to applications. - Installed Helm 3 or later and have privileged user permissions. > [!IMPORTANT] > > - If you use Helm to manage your Runtime Fabric installation, you can use the `rtfctl` command > line utility later to manage Mule license keys and proxies. However, you’ll need to track any > post-installation changes you make, as explained in the [upgrade documentation](https://docs.mulesoft.com/runtime-fabric/2.7/upgrade-helm). ### Helm Support Runtime Fabric supports installations, upgrades, and rollbacks using Helm for versions 1.13 and later. ## Create a Runtime Fabric Using Runtime Manager To install Runtime Fabric with Helm, first create a Runtime Fabric using Runtime Manager. This is required to obtain the activation data that is needed during installation. 1. From Anypoint Platform, select Runtime Manager. 2. Click **Runtime Fabrics**. 3. Click **Create Runtime Fabric**. 4. Enter the name of the new Runtime Fabric, then select one of the following options: - Amazon Elastic Kubernetes Service - Azure Kubernetes Service - Google Kubernetes Engine 5. Review the Support responsibility disclaimer, and if you agree, click **Accept**. 6. Click Helm. > [!NOTE] The remaining steps in the Helm-install process reference placeholder values. You can > retrieve the actual values from Runtime Manager when you create the Runtime Fabric instance. ## Create A Namespace for Runtime Fabric You must create a namespace named `rtf` in your Kubernetes cluster. This namespace is where you install Runtime Fabric components. To create the namespace, run: ```copy kubectl create ns rtf ``` Using `rtf` as a namespace applies only in the case of single cluster or single instance. ## Create A Docker Pull Secret After you create the namespace, create a pull secret so you can retrieve the Docker images needed to install and run Runtime Fabric. The default registry URL is `rtf-runtime-registry.kprod.msap.io`. If you’re using a local registry, specify those values here. To create the pull secret, run: ```copy kubectl create secret docker-registry --namespace rtf --docker-server= --docker-username= --docker-password= ``` ## Add the Runtime Fabric Helm Repository You need to add the Runtime Fabric Helm repo to the namespace you created. The Runtime Fabric Helm repo contains the chart needed to install Runtime Fabric. To add the Helm repo, run: ```copy helm repo add --username --password ``` > [!NOTE] If you already added the Helm repo, and you get a result that Runtime Fabric skipped > adding the repo, run `helm repo update` before installing, or upgrading to, a new Runtime Fabric > version. ## (Optional) Configure Authorized Namespaces You can optionally configure [authorized namespaces](https://docs.mulesoft.com/runtime-fabric/2.7/authorized-namespaces), which enable you to deploy Runtime Fabric alongside other services in a Kubernetes cluster. ### Before You Begin Before configuring authorized namespaces, note the following: - You must create the `authorized-namespaces` ConfigMap file _before_ installing Runtime Fabric. Additionally, you must name the ConfigMap, `authorized-namespaces`. - The `rtf:resource-metrics-collector` ClusterRole has cluster-wide permissions to `get` and `list` nodes, pods, and namespaces and has `watch` permissions for nodes. The role ClusterRole is defined as follows: apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: rtf:resource-metrics-collector labels: {{- include "labels.standard" . | nindent 4 }} rules: - apiGroups: \[""\] resources: \["nodes", "pods", "namespaces"\] verbs: \["list", "get"\] - apiGroups: \[""\] resources: \["nodes"\] verbs: \["watch"\] 1. In your cluster, create an additional namespace for application deployments, and add the necessary labels to the namespace. To do so, create a YAML file with the following contents: ```copy apiVersion: v1 kind: Namespace metadata: name: labels: rtf.mulesoft.com/agentNamespace: rtf.mulesoft.com/envId: rtf.mulesoft.com/org: rtf.mulesoft.com/role: workers ``` 2. Apply the file you just created: ```copy kubectl apply -f .yaml ``` 3. Repeat steps 1 and 2 to add as many namespaces as you need. 4. Create the RoleBinding for the Runtime Fabric agent ClusterRole that includes the Runtime Fabric agent ServiceAccount. To do so, apply the following configuration in your additional namespace: ```copy kind: RoleBinding apiVersion: rbac.authorization.k8s.io/v1 metadata: name: namespace: subjects: - kind: ServiceAccount name: rtf-agent namespace: # If using persistence gateway uncomment and provide the following. Ref: https://docs.mulesoft.com/runtime-fabric/latest/persistence-gateway#persistence-gateway-with-authorized-namespaces # subjects: # - kind: ServiceAccount # name: rtf-persistence-gateway # namespace: roleRef: kind: ClusterRole name: rtf:agent apiGroup: rbac.authorization.k8s.io ``` To use clustered apps in authorized namespaces mode, the following RoleBinding must be created: ```yaml apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: name: rtf-mule-clusterip-service namespace: subjects: - kind: ServiceAccount name: mule-clusterip-service namespace: roleRef: kind: ClusterRole name: rtf:mule-clusterip-service apiGroup: rbac.authorization.k8s.io ``` 5. In the `rtf` namespace, create a ConfigMap file named `authorized-namespaces` and list any additional namespaces: ```copy apiVersion: v1 kind: ConfigMap metadata: name: authorized-namespaces namespace: data: ADDITIONAL_NAMESPACE_1: "additional-namespace1" ADDITIONAL_NAMESPACE_2: "additional-namespace2" ``` 6. If, after fully installing Runtime Fabric, you later add or delete any namespaces from the ConfigMap, you must restart the Runtime Fabric agent pod. To do so, run the following command: ```copy kubectl -nrtf delete po -l app=agent ``` After you delete the pod, Kubernetes starts a new one. ## Install Runtime Fabric To install Runtime Fabric, use the `values.yml` file supplied by Runtime Manager. 1. Download the `values.yml` file. 2. Add any optional parameters needed. If you’re using authorized namespaces, set `authorizedNamespaces` to `true`. 3. Run the following command: ```copy helm install runtime-fabric rtf/rtf-agent --version -f values.yaml -n ``` ## Values.yml Reference The following is an example `values.yml` file. ```yaml activationData: proxy: http_proxy: http_no_proxy: monitoring_proxy: muleLicense: customLog4jEnabled: false global: nodeWatcherEnabled: true deploymentRateLimitPerSecond: 1 authorizedNamespaces: false image: rtfRegistry: rtf-runtime-registry.kqa.msap.io pullSecretName: rtf-pull-secret containerLogPaths: - /var/lib/docker/containers - /var/log/containers - /var/log/pods ``` > [!NOTE] If you are configuring a Runtime Fabric BYOK with an EU control plane, review the changes > in > [Hostname Configuration](https://docs.mulesoft.com/runtime-fabric/latest/install-self-managed-network-configuration#hostname-configuration) > for a correct configuration. Specifically, the property > `rtfRegistry: rtf-runtime-registry.kprod-eu.msap.io`. ### Required Parameters These required values are created and added to `values.yml` when you create the Runtime Fabric in Runtime Manager:
KeyValueExample

activationData

Activation data

YW55cG9pbnQubXVsZXNvZnQuY29tOjBmODdmYzYzLTM3MWUtNDU2Yy1iODg5LTU5NTkyNjYyZjUxZQ==

rtfRegistry

Registry URL

rtf-runtime-registry.kprod.msap.io

pullSecretName

Registry secret

<pull_secret>

muleLicense

Mule license for applications

<mule_license_key>. Must be Base64 encoded.

### Optional Parameters Set these optional parameters in `values.yml` as needed before installing Runtime Fabric.
KeyValueExample

customLog4jEnabled

Enables or disables custom Log4j configurations

customLog4jEnabled: true, default is false

authorizedNamespaces

Enables or disables additional namespaces

authorizedNamespaces: true, default is false

crds.install

Enables crds installations

crds.install: true, for first Runtime Fabric installation and false for subsequent installations

  • proxy.http_proxy

  • proxy.http_no_proxy

Proxy and no_proxy values

proxy.monitoring_proxy

Anypoint Monitoring proxy values

socks5://<user>:<pass>@<10.0.0.2>:<8080>

global.containerLogPaths

The Filebeat read path

  • /var/lib/docker/

  • /var/log/containers

  • /var/log/pods

nodeWatcherEnabled

Enables or disables node watcher for the cluster

nodeWatcherEnabled:true default value true

deploymentRateLimitPerSecond

Sets the deployment rate limit per second

deploymentRateLimitPerSecond: 1 default value 1

## Insert the Mule License Key If you didn’t add the Mule license key during install, you can add it using the `rtfctl` command line utility or Helm. Before you install the license key, encode it to Base64 format. ### Encode the License Key - On MacOS, run the following command: ```copy base64 -b 0 -i ``` - On Unix, run the following command: ```copy base64 -w0 ``` - On Windows, choose one of the following: - Use a WSL or Cygwin shell that includes the base64 tool and use the above Unix command. - Use the base64.exe program included with Windows git (C:\\Program Files\\Git\\usr\\bin). - Use the following Powershell command: ```copy $BASE64_ENCODED_LICENSE=[convert]::ToBase64String((Get-Content -path "license.lic" -Encoding byte)) ``` ### Apply the License Key Using rtfctl 1. On the controller node acting as the leader during installation (the installer node), run the following command: ```copy rtfctl apply mule-license $BASE64_ENCODED_LICENSE ``` You can also apply the Mule license providing the file path directly: ```copy rtfctl apply mule-license --file /path/to/license.lic ``` > [!NOTE] Any value used with `rtfcl apply` updates does not work for OpenShift. You have to > update the values in the OpenShift console. 2. To verify the Mule license key has applied correctly, run: ```copy rtfctl get mule-license ``` ### Apply the License Key Using Helm To apply the license using Helm, run the following command: ```copy helm upgrade runtime-fabric rtf/rtf-agent --set muleLicense=$BASE64_ENCODED_LICENSE -n rtf --reuse-values --version ``` ## Configure the Ingress Resource Template If your ingress controller requires custom annotations and ingress class definition, follow the instructions in [Defining a Custom Ingress Configuration](https://docs.mulesoft.com/runtime-fabric/2.7/custom-ingress-configuration). > [!NOTE] For GKE customers, the ingress controller included with GKE will provision a separate HTTP > load balancer per application by default. ## Validate Your Runtime Fabric After completing the installation, your Runtime Fabric should be activated within your Anypoint organization. To validate your installation, go to Anypoint Runtime Manager and confirm that the status of the Runtime Fabric is `Active`. Before deploying an application to your Runtime Fabric: 1. Associate the Runtime Fabric with at least one Anypoint environment. 2. Review and update the Inbound Traffic settings based upon your Kubernetes environment. 3. Deploy an application to verify that Runtime Fabric is installed and configured correctly. ## Perform a Rollback To roll back to a previous version of Runtime Fabric using helm, refer to the [Helm rollback](https://helm.sh/docs/helm/helm_rollback/) documentation for the command description. ## Retrieve Helm Registry Endpoints and Credentials To obtain the Helm registry endpoints and credentials, make a request to this API endpoint using a bearer token for authentication: `[https:///runtimefabric/api/organizations//helmrepoproperties](https://\/runtimefabric/api/organizations/\/helmrepoproperties)` Replace `` with your organization’s ID, and `` with your Anypoint Platform region URL. The API response has this structure: { "RTF\_IMAGE\_REGISTRY\_ENDPOINT": "rtf-runtime-registry.kprod.msap.io", "RTF\_IMAGE\_REGISTRY\_USER": "username/us-east-1/truncated", "RTF\_IMAGE\_REGISTRY\_PASSWORD": "Truncated" } The URL for the Helm repository containing the Helm charts is constructed as follows: `{RTF_IMAGE_REGISTRY_ENDPOINT}/charts`. For example: `rtf-runtime-registry.kprod.msap.io/charts` ## See Also - [Configure Ingress for Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/custom-ingress-configuration) - [Deploy a Mule Application to Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/2.7/deploy-to-runtime-fabric)