diff --git a/README.md b/README.md index 56aae42d01..c55b044c7c 100644 --- a/README.md +++ b/README.md @@ -43,11 +43,11 @@ If `~/.local/bin` is on your PATH, you will then be able to run subctl. To deploy submariner in a two Kubernetes cluster setup follow the below steps -* Deploy Broker with Dataplane - To deploy the Submariner broker along with the data cluster run +* Deploy Broker with Dataplane - To deploy the Submariner broker along with the dataplane on the same cluster run: ``` subctl deploy-broker --kubeconfig --dataplane --clusterid ``` - +Note, if --dataplane (enabled by default) was set, it is not required to join this cluster, as it was already joined. It is only required to join the other clusters. * Join Clusters with Broker - To join all the other clusters with the broker cluster, run using the broker-info.subm generated in the folder from which the previous step was run. @@ -66,17 +66,32 @@ The [Lighthouse](https://github.com/submariner-io/lighthouse) project helps in c To deploy Submariner with Lighthouse follow the below steps. -* Deploy Broker with Dataplane - To deploy the Submariner broker along with the data cluster, run using the broker-info.subm generated in the folder from which the previous step was run. +* Create a kubeconfig file which has the context of all the clusters. If KUBECONFIG environment variable set with the path to all clusters (like KUBECONFIG=/home/user/.config/east/auth/kubeconfig-dev:/home/user/.config/west/auth/kubeconfig-dev), you could use the below command. ``` -subctl deploy-broker --kubeconfig --dataplane --service-discovery --broker-cluster-context --clusterid +kubectl config view --flatten > merged_kubeconfig ``` -* Join Clusters with Broker - To join all the other clusters with the broker cluster run using the broker-info.subm generated in the folder from which the previous step was run. +* Deploy Broker with Dataplane - To deploy the Submariner broker along with the dataplane on the same cluster run: +``` +subctl deploy-broker --kubecontext --kubeconfig --dataplane --service-discovery --broker-cluster-context --clusterid +``` +Note, if --dataplane (enabled by default) was set, it is not required to join this cluster, as it was already joined. It is only required to join the other clusters. +For example ``` -subctl join --kubeconfig broker-info.subm --broker-cluster-context --clusterid +subctl deploy-broker --kubecontext west --kubeconfig $WEST --dataplane --service-discovery --broker-cluster-context west --clusterid west ``` +* Join Clusters with Broker - To join all the other clusters with the broker cluster run using the broker-info.subm generated in the folder from which the previous step was run and use the merged kubeconfig created in the first step. + +``` +subctl join --kubecontext --kubeconfig broker-info.subm --broker-cluster-context --clusterid +``` + +For example +``` +subctl join --kubecontext east --kubeconfig merged_kubeconfig broker-info.subm --broker-cluster-context west --clusterid east +``` # Development