docs: add script to allow users to join upstream clusters to fleet hub (#187)

Author: Arvindthiru

hack/membership/joinMC.sh

@@ -0,0 +1,69 @@
+# CAN ONLY BE RUN AFTER CREATING NEEDED HUB CLUSTER, MEMBER CLUSTERS AND AFTER INSTALLING THE FLEET MEMBER AGENT ON EACH MEMBER CLUSTER.
+# This can be achieved by running the script in fleet/hack/Azure/setup/joinMC.sh in the fleet repository https://github.com/Azure/fleet.
+# This script installs the fleet-networking member agents on each member cluster.
+
+export REFRESH_TOKEN_IMAGE_TAG="$1"
+export FLEET_NETWORKING_AGENT_IMAGE_TAG="$2"
+
+export HUB_CLUSTER="$3"
+export HUB_CLUSTER_CONTEXT=$(kubectl config view -o jsonpath="{.contexts[?(@.context.cluster==\"$HUB_CLUSTER\")].name}")
+export HUB_CLUSTER_ADDRESS=$(kubectl config view -o jsonpath="{.clusters[?(@.name==\"$HUB_CLUSTER\")].cluster.server}")
+
+for MC in "${@:4}"; do
+
+export MEMBER_CLUSTER=$(kubectl config view -o jsonpath="{.contexts[?(@.context.cluster==\"$MC\")].name}")
+export MEMBER_CLUSTER_CONTEXT=$(kubectl config view -o jsonpath="{.contexts[?(@.context.cluster==\"$MC\")].name}")
+
+echo "Switching to member cluster context..."
+kubectl config use-context $MEMBER_CLUSTER_CONTEXT
+
+echo "Apply the Fleet networking CRDs..."
+kubectl apply -f config/crd/*
+
+# # Install the fleet-networking member agent helm charts on the member cluster.
+# The variables below uses the fleet-networking images kept in the Microsoft Container Registry (MCR)
+echo "Retrieving image..."
+export REGISTRY="mcr.microsoft.com/aks/fleet"
+export MCS_CONTROLLER_MANAGER_IMAGE="mcs-controller-manager"
+export MEMBER_NET_CONTROLLER_MANAGER_IMAGE="member-net-controller-manager"
+export REFRESH_TOKEN_IMAGE="${REFRESH_TOKEN_NAME:-refresh-token}"
+export OUTPUT_TYPE="${OUTPUT_TYPE:-type=docker}"
+
+echo "Uninstalling mcs-controller-manager..."
+helm uninstall mcs-controller-manager --wait
+
+echo "Installing mcs-controller-manager..."
+helm install mcs-controller-manager ./charts/mcs-controller-manager/ \
+--set image.repository=$REGISTRY/$MCS_CONTROLLER_MANAGER_IMAGE \
+--set refreshtoken.repository=$REGISTRY/$REFRESH_TOKEN_IMAGE \
+--set refreshtoken.tag=$REFRESH_TOKEN_IMAGE_TAG \
+--set image.tag=$FLEET_NETWORKING_AGENT_IMAGE_TAG \
+--set image.pullPolicy=Always \
+--set refreshtoken.pullPolicy=Always \
+--set config.hubURL=$HUB_CLUSTER_ADDRESS \
+--set config.memberClusterName=$MEMBER_CLUSTER \
+--set enableV1Alpha1APIs=false \
+--set enableV1Beta1APIs=true \
+--set logVerbosity=8
+
+echo "Uninstalling member-net-controller-manager..."
+helm uninstall member-net-controller-manager --wait
+
+echo "Installing member-net-controller-manager..."
+helm install member-net-controller-manager ./charts/member-net-controller-manager/ \
+--set image.repository=$REGISTRY/$MEMBER_NET_CONTROLLER_MANAGER_IMAGE \
+--set refreshtoken.repository=$REGISTRY/$REFRESH_TOKEN_IMAGE \
+--set refreshtoken.tag=$REFRESH_TOKEN_IMAGE_TAG \
+--set image.tag=$FLEET_NETWORKING_AGENT_IMAGE_TAG \
+--set timage.pullPolicy=Always \
+--set refreshtoken.pullPolicy=Always \
+--set config.hubURL=$HUB_CLUSTER_ADDRESS \
+--set config.memberClusterName=$MEMBER_CLUSTER \
+--set enableV1Alpha1APIs=false \
+--set enableV1Beta1APIs=true \
+--set logVerbosity=8
+
+kubectl get pods -A
+kubectl config use-context $HUB_CLUSTER_CONTEXT
+kubectl get membercluster $MEMBER_CLUSTER
+done