Agent Configuration and Installation

This document helps to configure and install the Agent in the following two scenarios:

ISD and ArgoCd both are running in the same cluster.
ISD runs in one cluster and Argocd runs in a different cluster.

ISD and ArgoCd both are running in the same cluster

Follow the steps below to configure and install the Agent where ISD and ArgoCd both are running in the same cluster.

Connect to the cluster where you have installed ISD and ArgoCD applications.

Run the below command to edit the controller config map and replace the URL as mentioned below.

kubectl edit cm opsmx-controller-controller1 -n <NAMESPACE NAME>

Replace the URL in the config map under “data” section as mentioned below and save it.

data:
  configFile: |
    serviceHostname: opsmx-controller-controller1
    agentHostname: agent-grpc.<NAMESPACE NAME>.svc.cluster.local
    remoteCommandHostname: agent-grpc.<NAMESPCAE NAME>.svc.cluster.local
    controlHostname: opsmx-controller-controller1

Restart controller pod in your application using the below command.

kubectl rollout restart deploy opsmx-controller-controller1 -n <NAMESPACE NAME>

Login to the ISD application.
Create the Agent in “ISD for Argo'' UI and Download the manifest file to your local machine. For more information on how to create an Agent, refer here.
Modify the below-mentioned details in the agent manifest file that you have downloaded and save it. Search with namespace in the Agent manifest file which is downloaded from the ISD UI and replace the “namespace : default” with namespace value where Argocd is running and save the file.
```
subjects:
- kind: ServiceAccount
  name: opsmx-agent-argocdhelm
  namespace: <namespace name>
```
Modify the replicas under spec section as per your requirements (by default it will have three).
```
spec:
  replicas: 1
```

Create a new config map as shown below and modify the fields wherever mentioned.

apiVersion: v1
kind: ConfigMap
metadata:
  name: opsmx-services-<Provide Agent name which is added in ISD UI>
  labels:
    agent.opsmx.com/name: <Provide Agent name which is added in ISD UI>
    agent.opsmx.com/role: agent
data:
  services.yaml: |
    outgoingServices:
      - name: argocd
        type: argocd
        enabled: true
        config:
          url: http://<Provide ArgoCD service name here>:80
          insecure: true
          credentials:
            type: bearer
            token: <Provide base64 encoded Argo CD token here>
        annotations:
          description: argocd via agent
          uiUrl: https://<Provide your Argo CD url here>

You can generate the token in the Argo CD application. Follow the instructions below to generate the token.
- Login to Argo CD application
- In the Application Dashboard, click on the “Settings” icon in the left-side navigation pane and then click on “Accounts”. Refer to the image below.
- Select the user and click on “Generate New”. Refer to the image below.
- Now you will get a token. Copy that token, encode it to base64 format, and then provide it in the config map.

Apply the agent and config map files in your cluster using the below command.

kubectl apply -f <agent file> -n <namespace name>
kubectl apply -f <cm file> -n <namespace name>

Now go to the ISD UI and refresh it, you will see the Agent in healthy status, which means the agent is successfully connected to ISD. Refer to the image below.

ISD and ArgoCd are running in two different clusters

Follow the steps below to configure and install the Agent where ISD is running in one cluster and ArgoCd is running in a different cluster.

Note: If agent-grpc service external IP is already mapped to an agent host URL as part of Autopilot installation and updated in controller configmap, please ignore steps 1 to 5.

Prepare a URL for agent grpc IP mapping as per your agent host URL.
Map ISD agent-grpc external IP to agent host Url.
To get agent-grpc external IP, connect to Kubernetes cluster where you have installed the ISD application and run the below command in your cluster.
```
kubectl get svc -n <ISD NAMESPACE-NAME> | grep grpc
```
Note: ISD namespace is the namespace where you have installed your ISD application.

Edit the controller config map and replace the URL as mentioned below. To edit the config map run the below command.

kubectl edit cm opsmx-controller-controller1 -n <ISD NAMESPACE-NAME>

Replace the URL in the config map under “data” section as mentioned below and save it.

data:
  configFile: |
    serviceHostname: opsmx-controller-controller1
    agentHostname: <Provide your agent Host url here >
    remoteCommandHostname: <Provide your agent Host url here>
    controlHostname: opsmx-controller-controller1

Restart the controller pod using the command below.

kubectl rollout restart deploy opsmx-controller-controller1 -n <ISD NAMESPACE-NAME>

Login to ISD application.
Create the Agent in ISD UI and Download the manifest file to your local machine. For more information on how to create an Agent, refer here.
Modify the following highlighted fields from the agent manifest file and save it. Search with namespace in the Agent manifest file which is downloaded from the ISD UI and replace the “namespace : default” with namespace value where argocd is running and save the file.
```
subjects:
- kind: ServiceAccount
  name: opsmx-agent-argocdhelm
  namespace: <NAMESPACE-NAME>
```
Modify the replicas under spec section as per your requirements(by default it will have three)
```
spec:
  replicas: 1
```

Create a new config map as shown below and modify the fields wherever mentioned.

apiVersion: v1
kind: ConfigMap
metadata:
  name: opsmx-services-<Provide Agent name which is added in ISD UI>
  labels:
    agent.opsmx.com/name: <Provide Agent name which is added in ISD UI>
    agent.opsmx.com/role: agent
data:
  services.yaml: |
    outgoingServices:
      - name: argocd
        type: argocd
        enabled: true
        config:
          url: http://<Provide ArgoCD service name here>:80
          insecure: true
          credentials:
            type: bearer
            token: <Provide base64 encoded Argo CD token here>
        annotations:
          description: argocd via agent
          uiUrl: https://<Provide your Argo CD url here>

You can generate the token in the Argo CD application. Follow the instructions below to generate the token.
- Login to ArgoCD application
- In the Application Dashboard, click on the “Settings” icon in the left-side navigation pane and then click on “Accounts”. Refer to the image below.
- Select the user and click on “Generate New”. Refer to the image below.
- Now you will get a token. Copy that token and encode it to base64 format and then provide it in the config map.
Connect to Kubernetes cluster where you have installed Argo CD and Rollouts(Worker OEA install).

Apply agent file and config map file in your cluster using below command.

 kubectl apply -f <cm file> -n <NAMESPACE-NAME>           
 kubectl apply -f <agent file> -n <NAMESPACE-NAME>

Now go to the ISD UI and refresh it, you will see the Agent in healthy status, which means the agent is successfully connected to ISD. Refer to the image below.

PreviousAgent Creation NextEdit and Delete Agent

Last updated 1 year ago