ArgoCD

This page will walk you through the installation of the Port execution agent in your Kubernetes cluster using ArgoCD, utilizing its Helm Capabilities.

Helm chart resources

• You can observe the Helm chart and the available parameters here.
• For the full chart versions list refer to the releases page.

Prerequisites

• kubectl must be installed to apply your installation manifest.
• Helm must be installed to use the chart. Please refer to the Helm documentation for further details about the installation.
• ArgoCD must be installed in your Kubernetes cluster. Please refer to ArgoCD's documentation for further details about the installation.
• You will need your Port credentials.
• The connection credentials to Kafka are provided to you by Port.
• If you want to trigger a GitLab Pipeline, you need to have a GitLab trigger token

Installation

1. In your git repo, create a directory called argocd.

mkdir argocd

2. Inside your argocd directory create another directory for the current installation. For our example we use my-port-agent.

mkdir -p argocd/my-port-agent

3. Create a values.yaml file in your my-port-agent directory, you can use it to override the helm chart values. Commit the changes to your git repository.

4. Install the my-port-agent ArgoCD Application by creating the following my-port-agent.yaml manifest:

   Remember to replace the placeholders for YOUR_ORG_ID, YOUR_KAFKA_CONSUMER_GROUP, YOUR_PORT_CLIENT_ID YOUR_PORT_CLIENT_SECRET and YOUR_GIT_REPO_URL.

   Multiple sources ArgoCD documentation can be found here.

   ArgoCD application (click to expand)

   apiVersion: argoproj.io/v1alpha1
   kind: Application
   metadata:
     name: my-port-agent
     namespace: argocd
   spec:
     destination:
       namespace: my-port-agent
       server: https://kubernetes.default.svc
     project: default
     sources:
     - repoURL: 'https://port-labs.github.io/helm-charts/'
       chart: port-agent
       targetRevision: 0.7.2
       helm:
         valueFiles:
           - $values/argocd/my-port-agent/values.yaml
         parameters:
           - name: env.normal.KAFKA_CONSUMER_GROUP_ID
             value: YOUR_KAFKA_CONSUMER_GROUP
           - name: env.normal.PORT_ORG_ID
             value: YOUR_ORG_ID
           - name: env.normal.STREAMER_NAME
             value: KAFKA
           - name: env.secret.PORT_CLIENT_ID
             value: YOUR_PORT_CLIENT_ID
           - name: env.secret.PORT_CLIENT_SECRET
             value: YOUR_PORT_CLIENT_SECRET
     - repoURL: YOUR_GIT_REPO_URL
       targetRevision: main
       ref: values
     syncPolicy:
       automated:
         prune: true
         selfHeal: true
       syncOptions:
       - CreateNamespace=true

   
   

5. Apply your application manifest with kubectl:

   kubectl apply -f my-port-agent.yaml

Done! The exporter will begin creating and updating objects from your Kubernetes cluster as Port entities shortly.

Next Steps

• Refer to the usage guide to set up a self-service action that sends a webhook.
• Customize the payload mapping to control the payload sent to the target.