https://github.com/appuio/appuio-cloud-agent

An controller running on every APPUiO Cloud Zone
https://github.com/appuio/appuio-cloud-agent

vshn-project-apub vshn-team-aldebaran

Last synced: 6 days ago
JSON representation

An controller running on every APPUiO Cloud Zone

• Host: GitHub
• URL: https://github.com/appuio/appuio-cloud-agent
• Owner: appuio
• License: bsd-3-clause
• Created: 2022-04-01T11:02:43.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2024-04-12T15:21:10.000Z (9 months ago)
• Last Synced: 2024-04-12T23:34:17.567Z (9 months ago)
• Topics: vshn-project-apub, vshn-team-aldebaran
• Language: Go
• Homepage:
• Size: 738 KB
• Stars: 0
• Watchers: 7
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

README

        
# APPUiO Cloud Agent

[![Build](https://img.shields.io/github/workflow/status/appuio/appuio-cloud-agent/Test)][build]

![Go version](https://img.shields.io/github/go-mod/go-version/appuio/appuio-cloud-agent)

[![Version](https://img.shields.io/github/v/release/appuio/appuio-cloud-agent)][releases]

[![Maintainability](https://img.shields.io/codeclimate/maintainability/appuio/appuio-cloud-agent)][codeclimate]

[![Coverage](https://img.shields.io/codeclimate/coverage/appuio/appuio-cloud-agent)][codeclimate]

[![GitHub downloads](https://img.shields.io/github/downloads/appuio/appuio-cloud-agent/total)][releases]

[build]: https://github.com/appuio/appuio-cloud-agent/actions?query=workflow%3ATest

[releases]: https://github.com/appuio/appuio-cloud-agent/releases

[codeclimate]: https://codeclimate.com/github/appuio/appuio-cloud-agent

The APPUiO Cloud Agent is a controller running on every APPUiO Cloud Zone.

## Run locally

## Local development environment

You can setup a [kind]-based local environment with

```bash

make kind

export KUBECONFIG=.kind/kind-kubeconfig-v1.23.0

```

[kind]: https://kind.sigs.k8s.io/

### Running the agent locally

You can run the agent locally against the currently configured Kubernetes cluster with

```bash

make run

```

To access the locally running controller webhook server, you need to register it with the [kind]-based local environment.

You can do this by applying the following manifests:

```

HOSTIP=$(docker inspect appuio-cloud-agent-v1.23.0-control-plane | jq '.[0].NetworkSettings.Networks.kind.Gateway')

# Under Docker for Mac `docker.for.mac.localhost` can be used instead of the host IP.

# HOSTIP=docker.for.mac.localhost

cat < tk/kustomization.yaml

resources:

- ../config/foreign_rbac

namespace: ${NAMESPACE}

namePrefix: ${ZONE_NAME}-

EOF

kubectl apply -k tk

CONTEXT=$(kubectl config current-context)

NEW_CONTEXT=control-api-sa

KUBECONFIG_FILE="kubeconfig-control-api"

SECRET_NAME=${ZONE_NAME}-cloud-agent

TOKEN_DATA=$(kubectl get secret ${SECRET_NAME} \

  --context ${CONTEXT} \

  --namespace ${NAMESPACE} \

  -o jsonpath='{.data.token}')

TOKEN=$(echo ${TOKEN_DATA} | base64 -d)

rm -rf tk

# Create kubeconfig

kubectl config view --raw > ${KUBECONFIG_FILE}.full.tmp

kubectl --kubeconfig ${KUBECONFIG_FILE}.full.tmp config use-context ${CONTEXT}

kubectl --kubeconfig ${KUBECONFIG_FILE}.full.tmp \

  config view --flatten --minify > ${KUBECONFIG_FILE}.tmp

# Rename context

kubectl config --kubeconfig ${KUBECONFIG_FILE}.tmp \

  rename-context ${CONTEXT} ${NEW_CONTEXT}

# Create token user

kubectl config --kubeconfig ${KUBECONFIG_FILE}.tmp \

  set-credentials ${CONTEXT}-${NAMESPACE}-token-user \

  --token ${TOKEN}

kubectl config --kubeconfig ${KUBECONFIG_FILE}.tmp \

  set-context ${NEW_CONTEXT} --user ${CONTEXT}-${NAMESPACE}-token-user

# Set context to correct namespace

kubectl config --kubeconfig ${KUBECONFIG_FILE}.tmp \

  set-context ${NEW_CONTEXT} --namespace ${NAMESPACE}

# Flatten/minify kubeconfig

kubectl config --kubeconfig ${KUBECONFIG_FILE}.tmp \

  view --flatten --minify > ${KUBECONFIG_FILE}

# Remove tmp

rm ${KUBECONFIG_FILE}.full.tmp

rm ${KUBECONFIG_FILE}.tmp

```