Configuring the Kubernetes on-premises connector
You configure the connector and the actions supported by the connector are displayed while creating a policy. BMC Helix Intelligent Automation supports creating policies for both Kubernetes on-premises and cloud deployments.
For more information, see Configuring the Kubernetes cloud connector.
To configure an on-premises connector, you first create a plugin key, download the plugin installer, create credentials, and then run the plugin. After configuration, the relevant actions for a connector are available during policy creation. If a plugin key is used in a connector configuration once, you can reuse it for multiple connectors.
Task 1: To create a plugin key
- In the BMC Helix Intelligent Automation console, click Connectors > Plugin Keys tab.
- Click Create Plugin Key and do the following steps:
- (Optional) Enter a new name for the plugin with which you want to associate the plugin key.
(Optional) Update the expiry date for the plugin key.
By default, a plugin key expires in 90 days. To ensure that the connector is running, you can extend the date before it expires.Click Download Plugin Key.
A creds.json file gets downloaded.Warning
If you close the Create Plugin Key panel before downloading the key, you cannot download and use the plugin key. Instead, you need to create a new plugin key.
Click Save.
The plugin and the associated plugin key appear on the Plugins page.
Optional Task: To reuse an existing plugin key
If you have configured any on-premises connector, you already have a plugin key. You can use the same key to configure any other on-premises connector.
- In the BMC Helix Intelligent Automation console, click Connectors > Available Connectors and click Configure against the connector that you want to configure.
- On the following message that appears on the configure connector page, click the download & install link.
On the Configure On-premises Connector page, the plugin keys available for reuse are displayed. - Skip Task 2 and continue with Task 3 to configure the connector.
Task 2: To download the plugin
You can download and run a plugin on a Linux or a Microsoft Windows server. This server should be accessible from the computer where the automation tool or application is installed.
- In the BMC Helix Intelligent Automation console, click Connectors > Available Connectors and click Configure against the connector.
- On the following message that appears on the configure connector page, click the download & install link.
- On the Configure On-premises Connector page, click Download Plugin.
The remote-restapi-plugin.zip file is downloaded. - Copy and extract the downloaded ZIP file and go to the remote-restapi-plugin directory.
- (For Linux only) Ensure that the run.sh file has the execute permission.
Task 3: To create credentials by using the plugin key
A plugin requires credentials to authenticate and execute various actions on the target applications that are defined in an automation policy. The credential CLI utility enables you to create, search, update, and delete credentials for a plugin. This server should be accessible from the server where the on-premise application is installed.
- Navigate to the directory where you have extracted the remote-restapi-plugin.zip file.
The remote-restapi-plugin directory contains credential.sh. - Ensure that the credential.sh file has the execute permission.
Run the following
create
switch command to create credentials.
Whenever credentials are created, a unique credential ID is assigned to it.Sample command for Microsoft Windowscredential.bat create -n <credentialsName> -i <http://host:port> -p <provider> -a <AuthenticationType>
Sample command for Linux./credential.sh create -n <credentialsName> -i <http://host:port> -p <provider> -a <AuthenticationType>
Example for Kubernetes./credential.sh create -n k8sCreds -i https://172.20.65.241:6443 -p kubernetes -a bearer
Tip: You can obtain the Kubernetes cluster URL and apikey (required later if you are using bearer authentication) from the $HOME/.kube/config file.
In the example:k8sCreds
is the name of the credentials.https://172.20.65.241:6443
is the Kubernetes cluster URL.Note
Ensure that you do not provide the same URL while configuring any other connector.
kubernetes
is the credential provider ID.bearer
is the authentication mechanism.
Enter the values for the following parameters when prompted:
Parameter
Value
api key Enter apikey. login required n Credentials are created successfully.
Task 4: To start and run the plugin as a service
If a remote plugin is installed as a service, you can start, stop, or restart it as any other service. BMC recommends that you run the plugin as a service as against running it as a batch or shell process. You can run remote plugin as a service only on Microsoft Windows Server 2016 Enterprise and CentOS 7 operating systems.
Before running a plugin as a service, ensure that the following prerequisites are fulfilled:
You have administrative or root privileges on the host where the plugin is extracted.
- The host where the plugin is available is also accessible from the host where the application is installed.
To run plugin as a service:
- Navigate to the directory where you have extracted the remote-restapi-plugin.zip file.
- Run the
install.bat
(for Microsoft Windows) orinstall.sh
(for Linux) command.
You can also use theinstall.bat install
command. The plugin now runs as a service.
If a service is installed successfully, in the list of services available in the Microsoft Windows Service Manager, the remote restapi plugin service is displayed. On Linux servers, if you run the install.sh status
command, a system process with the name BMC remote-restapi-plugin
appears.
Note
The credentials database is now stored at a new location. To ensure backward compatibility, copy the credential.db file from your previous location and place it in the new database location.
OS | Old location | New location |
---|---|---|
Microsoft Windows | C:\Users\Public\bmc\ia_remote_plugins\database | C:/ProgramData/BMC/ia_remote_plugins/database/ |
Linux | /root/.bmc/ia_remote_plugins/database/ | /var/lib/bmc/ia_remote_plugins/database/ |
Optional: To start the plugin as a batch or shell process
After successfully creating the credentials, run the plugin to enable the connector.
- Navigate to the remote-restapi-plugin/config directory, and replace the creds.json file with the creds.json file that you have downloaded while creating the plugin key.
- Run the run.sh script to start the plugin.
Task 5: To test the plugin
BMC recommends that you test whether the plugin is able to connect to the automation tool or application successfully before creating automation policies.
- In the BMC Helix Intelligent Automation console, click Connectors > PluginKeys.
- Click Actions > Test against the plugin that is used to configure the connector.
A message appears that shows that the connection is successful.
The Kubernetes connector is configured and appears in the Configured Connectors tab with the status as Connected. To view the status, click the icon.
If the connector is not successfully connected, the status appear as Disconnected. Click the icon to view the error message and fix the issue.
Where to go from here
Now that the connector is configured successfully, you can create policies to execute actions supported by Kubernetes. For more information, see Resizing a deployment.
Comments
Log in or register to comment.