Skip to content

Latest commit

 

History

History
86 lines (63 loc) · 5.39 KB

ManageConfigurations.md

File metadata and controls

86 lines (63 loc) · 5.39 KB

Managing Configurations

How to update configurations

Kubernetes resources for WSO2 products use Kubernetes ConfigMaps to pass on the minimum set of configurations required to setup a product deployment pattern.

For example, the minimum set of configurations required to setup pattern 1 of WSO2 API Manager can be found in <KUBERNETES_HOME>/pattern-1/confs directory. The Kubernetes ConfigMaps are generated from these files.

If you intend to pass on any additional configuration changes, you may use Kubernetes ConfigMaps. Follow the steps below to achieve it.

[1] In order to apply the updated configurations, WSO2 product server instances need to be restarted. Hence, un-deploy all the Kubernetes resources corresponding to the product deployment, if they are already deployed.

[2] Create a Kubernetes ConfigMap from the file(s), which contains the relevant configuration changes.

The need to create a Kubernetes ConfigMap may depend on the type of file(s) to be passed on to the cluster, as follows:

[i] If the additional configuration is part of a file, which is among the minimum set of files with configuration changes required to setup the particular product deployment pattern, use the same copy of the file to pass on the configuration.

e.g. <KUBERNETES_HOME>/pattern-1/confs/apim/carbon.xml is a file which is part of the minimum set of files with configuration changes required for pattern 1 of WSO2 API Manager. If you intend to make the configuration change in the <WSO2_APIM_HOME>/repository/conf/carbon.xml file in the product pack (which is the original file corresponding to <KUBERNETES_HOME>/pattern-1/confs/apim/carbon.xml file), make the configuration change within the file copy <KUBERNETES_HOME>/pattern-1/confs/apim/carbon.xml.

[ii] If the additional configuration file is not included among the minimum set of files with configuration changes required to setup a particular product deployment pattern, but is part of a directory within the original product pack to which you already pass other configuration files using a Kubernetes ConfigMap, include the file within the appropriate location in <KUBERNETES_HOME>/pattern-1/confs folder or any of its sub-folders.

e.g. Assume that you need to change a configuration in <WSO2_APIM_HOME>/repository/conf/datasources/metrics-datasources.xml file. <WSO2_APIM_HOME>/repository/conf/datasources/metrics-datasources.xml is not among the minimum set of configuration files adjusted for pattern 1 of WSO2 API Manager. A Kubernetes ConfigMap is already created from <KUBERNETES_HOME>/pattern-1/confs/datasources folder, passing configuration files to <WSO2_APIM_HOME>/repository/conf/datasources/ in the original product pack. Hence, you can add a copy of the metrics-datasources.xml with relevant changes to <KUBERNETES_HOME>/pattern-1/confs/datasources folder, in order to pass on the configuration file.

[iii] If the additional configuration file is not included among the minimum set of files with configuration changes required to setup a particular product deployment pattern and is not part of any directory within the original product pack to which you already pass other configuration files using Kubernetes ConfigMaps, follow the steps given below along with appropriate examples in each step.

For example, assume that you need to pass on a copy of the changed <WSO2_APIM_HOME>/repository/conf/tomcat/catalina-server.xml file to the Kubernetes cluster, for pattern 1 of WSO2 API Manager. <PATH_TO_CONFIG_FILE> is the path to a local copy of <WSO2_APIM_HOME>/repository/conf/tomcat/catalina-server.xml file.

  • Create a folder in your local machine's filesystem, add the file with configuration changes to the created folder and create a Kubernetes ConfigMap.

e.g.

# create a folder
mkdir config

# copy the changed configuration file to the created folder
cp <PATH_TO_CONFIG_FILE> config

# create a Kubernetes ConfigMap
kubectl create configmap apim-conf-tomcat --from-file=config/
  • Populate a volume with data stored in the created Kubernetes ConfigMap. For this purpose, update the appropriate Kubernetes Deployment resource(s). When mounting the created Kubernetes ConfigMap at the product container, it has to be mounted to the relevant path within the /home/wso2carbon/wso2-config-volume folder in the product container, while maintaining the appropriate WSO2 product home folder structure.

e.g. Update the volumes' (spec.template.spec.volumes) and volume mounts' (spec.template.spec.containers[wso2apim-with-analytics-apim-worker].volumeMounts) sections in <KUBERNETES_HOME>/pattern-1/apim/wso2apim-deployment.yaml file. The mountPath (which is /home/wso2carbon/wso2-config-volume/repository/conf/tomcat) has been derived based on the target folder structure within the original product pack (which is <WSO2_APIM_HOME>/repository/conf/tomcat) and assuming that /home/wso2carbon/wso2-config-volume is the product home root folder.

volumeMounts:
...
- name: apim-tomcat-config-volume
  mountPath: "/home/wso2carbon/wso2-config-volume/repository/conf/tomcat"

volumes:
...
- name: apim-tomcat-config-volume
  configMap:
    name: apim-conf-tomcat

[3] Deploy the Kubernetes resources as defined in section Quick Start Guide for the relevant deployment pattern.