operator/pkg/util: unit test kubeconfig

In this commit, we unit test kubeconfig utility in the karmada
operator package on building client from secret reference and checking
whether the given cluster is local or remote.

Signed-off-by: Mohamed Awnallah <mohamedmohey2352@gmail.com>
Co-authored-by: zhzhuang-zju <m17799853869@163.com>
This commit is contained in:
Mohamed Awnallah 2024-10-10 13:46:57 +03:00
parent c16e52a3ec
commit 95ba0cdee9
2 changed files with 258 additions and 1 deletions

View File

@ -61,7 +61,12 @@ func CreateBasic(serverURL, clusterName, userName string, caCert []byte) *client
}
}
// IsInCluster returns a bool represents whether the remote cluster is the local or not.
// IsInCluster checks if the specified host cluster is the local cluster.
// It returns true if:
// - the hostCluster is nil;
// - or its SecretRef is nil;
// - or the SecretRef's Name is an empty string.
// This indicates that the remote cluster is either not configured or not identifiable as the local cluster.
func IsInCluster(hostCluster *operatorv1alpha1.HostCluster) bool {
return hostCluster == nil || hostCluster.SecretRef == nil || len(hostCluster.SecretRef.Name) == 0
}

View File

@ -0,0 +1,252 @@
/*
Copyright 2024 The Karmada Authors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package util
import (
"context"
"crypto/rand"
"crypto/rsa"
"crypto/x509"
"encoding/base64"
"encoding/pem"
"errors"
"fmt"
"math/big"
"strings"
"testing"
"time"
corev1 "k8s.io/api/core/v1"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/runtime"
clientset "k8s.io/client-go/kubernetes"
fakeclientset "k8s.io/client-go/kubernetes/fake"
coretesting "k8s.io/client-go/testing"
operatorv1alpha1 "github.com/karmada-io/karmada/operator/pkg/apis/operator/v1alpha1"
)
func TestBuildClientFromSecretRef(t *testing.T) {
name, namespace := "test-secret", "test"
token := "my-sample-token"
kubeconfig := `
apiVersion: v1
clusters:
- cluster:
server: https://127.0.0.1:6443
certificate-authority-data: %s
name: test-cluster
contexts:
- context:
cluster: test-cluster
user: test-user
name: test-context
current-context: test-context
kind: Config
preferences: {}
users:
- name: test-user
user:
token: %s
`
tests := []struct {
name string
client clientset.Interface
ref *operatorv1alpha1.LocalSecretReference
wantErr bool
prep func(clientset.Interface) error
errMsg string
}{
{
name: "BuildClientFromSecretRef_GotNetworkIssue_FailedToBuildClient",
client: fakeclientset.NewSimpleClientset(),
ref: &operatorv1alpha1.LocalSecretReference{
Name: name,
Namespace: namespace,
},
prep: func(client clientset.Interface) error {
client.(*fakeclientset.Clientset).Fake.PrependReactor("get", "secrets", func(coretesting.Action) (bool, runtime.Object, error) {
return true, nil, errors.New("unexpected error: encountered a network issue while getting the secrets")
})
return nil
},
wantErr: true,
errMsg: "unexpected error: encountered a network issue while getting the secrets",
},
{
name: "BuildClientFromSecretRef_WithoutKubeConfig_KubeConfigIsNotFound",
client: fakeclientset.NewSimpleClientset(),
ref: &operatorv1alpha1.LocalSecretReference{
Name: name,
Namespace: namespace,
},
prep: func(client clientset.Interface) error {
secret := &corev1.Secret{
ObjectMeta: metav1.ObjectMeta{
Name: name,
Namespace: namespace,
},
Data: map[string][]byte{},
}
_, err := client.CoreV1().Secrets(namespace).Create(context.TODO(), secret, metav1.CreateOptions{})
if err != nil {
return fmt.Errorf("failed to create secret %s in %s namespace, got err: %v", name, namespace, err)
}
return nil
},
wantErr: true,
errMsg: "the kubeconfig or data key 'kubeconfig' is not found",
},
{
name: "BuildClientFromSecretRef_WithKubeconfig_ClientIsBuilt",
client: fakeclientset.NewSimpleClientset(),
ref: &operatorv1alpha1.LocalSecretReference{
Name: name,
Namespace: namespace,
},
prep: func(client clientset.Interface) error {
// Generate kubeconfig bytes.
caCert, err := generateTestCACertificate()
if err != nil {
return fmt.Errorf("failed to generate CA certificate: %v", err)
}
base64CACert := base64.StdEncoding.EncodeToString([]byte(caCert))
base64Token := base64.StdEncoding.EncodeToString([]byte(token))
kubeconfigBytes := []byte(fmt.Sprintf(kubeconfig, base64CACert, base64Token))
// Create secret with kubeconfig data.
secret := &corev1.Secret{
ObjectMeta: metav1.ObjectMeta{
Name: name,
Namespace: namespace,
},
Data: map[string][]byte{"kubeconfig": kubeconfigBytes},
}
_, err = client.CoreV1().Secrets(namespace).Create(context.TODO(), secret, metav1.CreateOptions{})
if err != nil {
return fmt.Errorf("failed to create secret %s in %s namespace, got err: %v", name, namespace, err)
}
return nil
},
wantErr: false,
},
}
for _, test := range tests {
t.Run(test.name, func(t *testing.T) {
if err := test.prep(test.client); err != nil {
t.Errorf("failed to prep before building client from secret ref: %v", err)
}
_, err := BuildClientFromSecretRef(test.client, test.ref)
if err == nil && test.wantErr {
t.Errorf("expected an error, but got none")
}
if err != nil && !test.wantErr {
t.Errorf("unexpected error, got: %v", err)
}
if err != nil && test.wantErr && !strings.Contains(err.Error(), test.errMsg) {
t.Errorf("expceted error message %s to be in %s", test.errMsg, err.Error())
}
})
}
}
func TestIsInCluster(t *testing.T) {
tests := []struct {
name string
hostCluster *operatorv1alpha1.HostCluster
want bool
}{
{
name: "IsInCluster_WithoutHostCluster_ItIsLocal",
hostCluster: nil,
want: true,
},
{
name: "IsInCluster_WithoutSecretRef_ItIsLocal",
hostCluster: &operatorv1alpha1.HostCluster{
SecretRef: nil,
},
want: true,
},
{
name: "IsInCluster_WithoutSecretRefName_ItIsLocal",
hostCluster: &operatorv1alpha1.HostCluster{
SecretRef: &operatorv1alpha1.LocalSecretReference{
Name: "",
},
},
want: true,
},
{
name: "IsInCluster_WithAllRemoteClusterConfigurations_ItIsRemote",
hostCluster: &operatorv1alpha1.HostCluster{
SecretRef: &operatorv1alpha1.LocalSecretReference{
Name: "remote-secret",
Namespace: "test",
},
},
want: false,
},
}
for _, test := range tests {
t.Run(test.name, func(t *testing.T) {
if got := IsInCluster(test.hostCluster); got != test.want {
t.Errorf("expected host cluster local status to be %t, but got %t", test.want, got)
}
})
}
}
// generateTestCACertificate returns a self-signed CA certificate as a PEM string.
func generateTestCACertificate() (string, error) {
// Generate a new RSA private key
priv, err := rsa.GenerateKey(rand.Reader, 2048)
if err != nil {
return "", err
}
// Set the certificate parameters.
notBefore := time.Now()
notAfter := notBefore.Add(365 * 24 * time.Hour)
serialNumber, err := rand.Int(rand.Reader, big.NewInt(1<<62))
if err != nil {
return "", err
}
cert := &x509.Certificate{
SerialNumber: serialNumber,
NotBefore: notBefore,
NotAfter: notAfter,
KeyUsage: x509.KeyUsageKeyEncipherment | x509.KeyUsageDigitalSignature,
ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth, x509.ExtKeyUsageClientAuth},
BasicConstraintsValid: true,
IsCA: true,
}
// Create the certificate.
certDER, err := x509.CreateCertificate(rand.Reader, cert, cert, &priv.PublicKey, priv)
if err != nil {
return "", err
}
// PEM encode the certificate.
certPEM := &pem.Block{Type: "CERTIFICATE", Bytes: certDER}
certPEMData := pem.EncodeToMemory(certPEM)
return string(certPEMData), nil
}