source-controller/pkg/minio/minio_test.go

607 lines
16 KiB
Go

/*
Copyright 2022 The Flux 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 minio
import (
"context"
"crypto/tls"
"crypto/x509"
"encoding/json"
"errors"
"fmt"
"log"
"net/http"
"net/url"
"os"
"path/filepath"
"strings"
"testing"
"time"
"github.com/google/uuid"
miniov7 "github.com/minio/minio-go/v7"
"github.com/minio/minio-go/v7/pkg/credentials"
"github.com/ory/dockertest/v3"
"github.com/ory/dockertest/v3/docker"
"gotest.tools/assert"
corev1 "k8s.io/api/core/v1"
v1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"github.com/fluxcd/pkg/apis/meta"
"github.com/fluxcd/pkg/sourceignore"
sourcev1 "github.com/fluxcd/source-controller/api/v1beta2"
testlistener "github.com/fluxcd/source-controller/tests/listener"
testproxy "github.com/fluxcd/source-controller/tests/proxy"
)
const (
objectName string = "test.yaml"
objectEtag string = "2020beab5f1711919157756379622d1d"
)
var (
// testMinioVersion is the version (image tag) of the Minio server image
// used to test against.
testMinioVersion = "RELEASE.2024-05-07T06-41-25Z"
// testMinioRootUser is the root user of the Minio server.
testMinioRootUser = "fluxcd"
// testMinioRootPassword is the root password of the Minio server.
testMinioRootPassword = "passw0rd!"
// testVaultAddress is the address of the Minio server, it is set
// by TestMain after booting it.
testMinioAddress string
// testMinioClient is the Minio client used to test against, it is set
// by TestMain after booting the Minio server.
testMinioClient *MinioClient
// testTLSConfig is the TLS configuration used to connect to the Minio server.
testTLSConfig *tls.Config
)
var (
bucketName = "test-bucket-minio" + uuid.New().String()
prefix = ""
secret = corev1.Secret{
ObjectMeta: v1.ObjectMeta{
Name: "minio-secret",
Namespace: "default",
},
Data: map[string][]byte{
"accesskey": []byte(testMinioRootUser),
"secretkey": []byte(testMinioRootPassword),
},
Type: "Opaque",
}
emptySecret = corev1.Secret{
ObjectMeta: v1.ObjectMeta{
Name: "minio-secret",
Namespace: "default",
},
Data: map[string][]byte{},
Type: "Opaque",
}
bucket = sourcev1.Bucket{
ObjectMeta: v1.ObjectMeta{
Name: "minio-test-bucket",
Namespace: "default",
},
Spec: sourcev1.BucketSpec{
BucketName: bucketName,
Provider: "generic",
SecretRef: &meta.LocalObjectReference{
Name: secret.Name,
},
},
}
bucketAwsProvider = sourcev1.Bucket{
ObjectMeta: v1.ObjectMeta{
Name: "minio-test-bucket",
Namespace: "default",
},
Spec: sourcev1.BucketSpec{
BucketName: bucketName,
Provider: "aws",
},
}
)
func TestMain(m *testing.M) {
// Uses a sensible default on Windows (TCP/HTTP) and Linux/MacOS (socket)
pool, err := dockertest.NewPool("")
if err != nil {
log.Fatalf("could not connect to docker: %s", err)
}
// Load a private key and certificate from a self-signed CA for the Minio server and
// a client TLS configuration to connect to the Minio server.
var serverCert, serverKey string
serverCert, serverKey, testTLSConfig, err = loadServerCertAndClientTLSConfig()
if err != nil {
log.Fatalf("could not load server cert and client TLS config: %s", err)
}
// Pull the image, create a container based on it, and run it
resource, err := pool.RunWithOptions(&dockertest.RunOptions{
Repository: "minio/minio",
Tag: testMinioVersion,
ExposedPorts: []string{
"9000/tcp",
"9001/tcp",
},
Env: []string{
"MINIO_ROOT_USER=" + testMinioRootUser,
"MINIO_ROOT_PASSWORD=" + testMinioRootPassword,
},
Cmd: []string{"server", "/data", "--console-address", ":9001"},
Mounts: []string{
fmt.Sprintf("%s:/root/.minio/certs/public.crt", serverCert),
fmt.Sprintf("%s:/root/.minio/certs/private.key", serverKey),
},
}, func(config *docker.HostConfig) {
config.AutoRemove = true
})
if err != nil {
log.Fatalf("could not start resource: %s", err)
}
purgeResource := func() {
if err := pool.Purge(resource); err != nil {
log.Printf("could not purge resource: %s", err)
}
}
// Set the address of the Minio server used for testing.
testMinioAddress = fmt.Sprintf("127.0.0.1:%v", resource.GetPort("9000/tcp"))
// Construct a Minio client using the address of the Minio server.
testMinioClient, err = NewClient(bucketStub(bucket, testMinioAddress),
WithSecret(secret.DeepCopy()),
WithTLSConfig(testTLSConfig))
if err != nil {
log.Fatalf("cannot create Minio client: %s", err)
}
// Wait until Minio is ready to serve requests...
if err := pool.Retry(func() error {
hCancel, err := testMinioClient.HealthCheck(1 * time.Second)
if err != nil {
log.Fatalf("cannot start Minio health check: %s", err)
}
defer hCancel()
if !testMinioClient.IsOnline() {
return fmt.Errorf("client is offline: Minio is not ready")
}
return nil
}); err != nil {
purgeResource()
log.Fatalf("could not connect to docker: %s", err)
}
ctx := context.Background()
createBucket(ctx)
addObjectToBucket(ctx)
run := m.Run()
removeObjectFromBucket(ctx)
deleteBucket(ctx)
purgeResource()
os.Exit(run)
}
func TestNewClient(t *testing.T) {
minioClient, err := NewClient(bucketStub(bucket, testMinioAddress),
WithSecret(secret.DeepCopy()),
WithTLSConfig(testTLSConfig))
assert.NilError(t, err)
assert.Assert(t, minioClient != nil)
}
func TestNewClientEmptySecret(t *testing.T) {
minioClient, err := NewClient(bucketStub(bucket, testMinioAddress),
WithSecret(emptySecret.DeepCopy()),
WithTLSConfig(testTLSConfig))
assert.NilError(t, err)
assert.Assert(t, minioClient != nil)
}
func TestNewClientAwsProvider(t *testing.T) {
minioClient, err := NewClient(bucketStub(bucketAwsProvider, testMinioAddress))
assert.NilError(t, err)
assert.Assert(t, minioClient != nil)
}
func TestBucketExists(t *testing.T) {
ctx := context.Background()
exists, err := testMinioClient.BucketExists(ctx, bucketName)
assert.NilError(t, err)
assert.Assert(t, exists)
}
func TestBucketNotExists(t *testing.T) {
ctx := context.Background()
exists, err := testMinioClient.BucketExists(ctx, "notexistsbucket")
assert.NilError(t, err)
assert.Assert(t, !exists)
}
func TestFGetObject(t *testing.T) {
ctx := context.Background()
tempDir := t.TempDir()
path := filepath.Join(tempDir, sourceignore.IgnoreFile)
_, err := testMinioClient.FGetObject(ctx, bucketName, objectName, path)
assert.NilError(t, err)
}
func TestNewClientAndFGetObjectWithSTSEndpoint(t *testing.T) {
// start a mock STS server
stsListener, stsAddr, stsPort := testlistener.New(t)
stsEndpoint := fmt.Sprintf("http://%s", stsAddr)
stsHandler := http.NewServeMux()
stsHandler.HandleFunc("PUT "+credentials.TokenPath,
func(w http.ResponseWriter, r *http.Request) {
_, err := w.Write([]byte("mock-token"))
assert.NilError(t, err)
})
stsHandler.HandleFunc("GET "+credentials.DefaultIAMSecurityCredsPath,
func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get(credentials.TokenRequestHeader)
assert.Equal(t, token, "mock-token")
_, err := w.Write([]byte("mock-role"))
assert.NilError(t, err)
})
var roleCredsRetrieved bool
stsHandler.HandleFunc("GET "+credentials.DefaultIAMSecurityCredsPath+"mock-role",
func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get(credentials.TokenRequestHeader)
assert.Equal(t, token, "mock-token")
err := json.NewEncoder(w).Encode(map[string]any{
"Code": "Success",
"AccessKeyID": testMinioRootUser,
"SecretAccessKey": testMinioRootPassword,
})
assert.NilError(t, err)
roleCredsRetrieved = true
})
stsServer := &http.Server{
Addr: stsAddr,
Handler: stsHandler,
}
go stsServer.Serve(stsListener)
defer stsServer.Shutdown(context.Background())
// start proxy
proxyAddr, proxyPort := testproxy.New(t)
tests := []struct {
name string
provider string
stsSpec *sourcev1.BucketSTSSpec
opts []Option
err string
}{
{
name: "with correct endpoint",
provider: "aws",
stsSpec: &sourcev1.BucketSTSSpec{
Provider: "aws",
Endpoint: stsEndpoint,
},
},
{
name: "with incorrect endpoint",
provider: "aws",
stsSpec: &sourcev1.BucketSTSSpec{
Provider: "aws",
Endpoint: fmt.Sprintf("http://localhost:%d", stsPort+1),
},
err: "connection refused",
},
{
name: "with correct endpoint and proxy",
provider: "aws",
stsSpec: &sourcev1.BucketSTSSpec{
Provider: "aws",
Endpoint: stsEndpoint,
},
opts: []Option{WithProxyURL(&url.URL{Scheme: "http", Host: proxyAddr})},
},
{
name: "with correct endpoint and incorrect proxy",
provider: "aws",
stsSpec: &sourcev1.BucketSTSSpec{
Provider: "aws",
Endpoint: stsEndpoint,
},
opts: []Option{WithProxyURL(&url.URL{Scheme: "http", Host: fmt.Sprintf("localhost:%d", proxyPort+1)})},
err: "connection refused",
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
roleCredsRetrieved = false
bucket := bucketStub(bucket, testMinioAddress)
bucket.Spec.Provider = tt.provider
bucket.Spec.STS = tt.stsSpec
minioClient, err := NewClient(bucket, append(tt.opts, WithTLSConfig(testTLSConfig))...)
assert.NilError(t, err)
assert.Assert(t, minioClient != nil)
ctx := context.Background()
tempDir := t.TempDir()
path := filepath.Join(tempDir, sourceignore.IgnoreFile)
_, err = minioClient.FGetObject(ctx, bucketName, objectName, path)
if tt.err != "" {
assert.ErrorContains(t, err, tt.err)
} else {
assert.NilError(t, err)
assert.Assert(t, roleCredsRetrieved)
}
})
}
}
func TestNewClientAndFGetObjectWithProxy(t *testing.T) {
proxyAddr, proxyPort := testproxy.New(t)
tests := []struct {
name string
proxyURL *url.URL
errSubstring string
}{
{
name: "with correct proxy",
proxyURL: &url.URL{Scheme: "http", Host: proxyAddr},
},
{
name: "with incorrect proxy",
proxyURL: &url.URL{Scheme: "http", Host: fmt.Sprintf("localhost:%d", proxyPort+1)},
errSubstring: "connection refused",
},
}
// run test
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
minioClient, err := NewClient(bucketStub(bucket, testMinioAddress),
WithSecret(secret.DeepCopy()),
WithTLSConfig(testTLSConfig),
WithProxyURL(tt.proxyURL))
assert.NilError(t, err)
assert.Assert(t, minioClient != nil)
ctx := context.Background()
tempDir := t.TempDir()
path := filepath.Join(tempDir, sourceignore.IgnoreFile)
_, err = minioClient.FGetObject(ctx, bucketName, objectName, path)
if tt.errSubstring != "" {
assert.ErrorContains(t, err, tt.errSubstring)
} else {
assert.NilError(t, err)
}
})
}
}
func TestFGetObjectNotExists(t *testing.T) {
ctx := context.Background()
tempDir := t.TempDir()
badKey := "invalid.txt"
path := filepath.Join(tempDir, badKey)
_, err := testMinioClient.FGetObject(ctx, bucketName, badKey, path)
assert.Error(t, err, "The specified key does not exist.")
assert.Check(t, testMinioClient.ObjectIsNotFound(err))
}
func TestVisitObjects(t *testing.T) {
keys := []string{}
etags := []string{}
err := testMinioClient.VisitObjects(context.TODO(), bucketName, prefix, func(key, etag string) error {
keys = append(keys, key)
etags = append(etags, etag)
return nil
})
assert.NilError(t, err)
assert.DeepEqual(t, keys, []string{objectName})
assert.DeepEqual(t, etags, []string{objectEtag})
}
func TestVisitObjectsErr(t *testing.T) {
ctx := context.Background()
badBucketName := "bad-bucket"
err := testMinioClient.VisitObjects(ctx, badBucketName, prefix, func(string, string) error {
return nil
})
assert.Error(t, err, fmt.Sprintf("listing objects from bucket '%s' failed: The specified bucket does not exist", badBucketName))
}
func TestVisitObjectsCallbackErr(t *testing.T) {
mockErr := fmt.Errorf("mock")
err := testMinioClient.VisitObjects(context.TODO(), bucketName, prefix, func(key, etag string) error {
return mockErr
})
assert.Error(t, err, mockErr.Error())
}
func TestValidateSecret(t *testing.T) {
t.Parallel()
testCases := []struct {
name string
secret *corev1.Secret
error bool
}{
{
name: "valid secret",
secret: secret.DeepCopy(),
},
{
name: "nil secret",
secret: nil,
},
{
name: "invalid secret",
secret: emptySecret.DeepCopy(),
error: true,
},
}
for _, testCase := range testCases {
tt := testCase
t.Run(tt.name, func(t *testing.T) {
t.Parallel()
err := ValidateSecret(tt.secret)
if tt.error {
assert.Error(t, err, fmt.Sprintf("invalid '%v' secret data: required fields 'accesskey' and 'secretkey'", tt.secret.Name))
} else {
assert.NilError(t, err)
}
})
}
}
func TestValidateSTSProvider(t *testing.T) {
t.Parallel()
tests := []struct {
name string
bucketProvider string
stsProvider string
err string
}{
{
name: "aws",
bucketProvider: "aws",
stsProvider: "aws",
},
{
name: "unsupported for aws",
bucketProvider: "aws",
stsProvider: "ldap",
err: "STS provider 'ldap' is not supported for 'aws' bucket provider",
},
{
name: "unsupported bucket provider",
bucketProvider: "gcp",
stsProvider: "gcp",
err: "STS configuration is not supported for 'gcp' bucket provider",
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
t.Parallel()
err := ValidateSTSProvider(tt.bucketProvider, tt.stsProvider)
if tt.err != "" {
assert.Error(t, err, tt.err)
} else {
assert.NilError(t, err)
}
})
}
}
func bucketStub(bucket sourcev1.Bucket, endpoint string) *sourcev1.Bucket {
b := bucket.DeepCopy()
b.Spec.Endpoint = endpoint
b.Spec.Insecure = false
return b
}
func createBucket(ctx context.Context) {
if err := testMinioClient.Client.MakeBucket(ctx, bucketName, miniov7.MakeBucketOptions{}); err != nil {
exists, errBucketExists := testMinioClient.BucketExists(ctx, bucketName)
if errBucketExists == nil && exists {
deleteBucket(ctx)
} else {
log.Fatalf("could not create bucket: %s", err)
}
}
}
func deleteBucket(ctx context.Context) {
if err := testMinioClient.Client.RemoveBucket(ctx, bucketName); err != nil {
log.Println(err)
}
}
func addObjectToBucket(ctx context.Context) {
fileReader := strings.NewReader(getObjectFile())
fileSize := fileReader.Size()
_, err := testMinioClient.Client.PutObject(ctx, bucketName, objectName, fileReader, fileSize, miniov7.PutObjectOptions{
ContentType: "text/x-yaml",
})
if err != nil {
log.Println(err)
}
}
func removeObjectFromBucket(ctx context.Context) {
if err := testMinioClient.Client.RemoveObject(ctx, bucketName, objectName, miniov7.RemoveObjectOptions{
GovernanceBypass: true,
}); err != nil {
log.Println(err)
}
}
func getObjectFile() string {
return `
apiVersion: source.toolkit.fluxcd.io/v1beta2
kind: Bucket
metadata:
name: podinfo
namespace: default
spec:
interval: 5m
provider: aws
bucketName: podinfo
endpoint: s3.amazonaws.com
region: us-east-1
timeout: 30s
`
}
func loadServerCertAndClientTLSConfig() (serverCert string, serverKey string, clientConf *tls.Config, err error) {
const certsDir = "../../internal/controller/testdata/certs"
clientConf = &tls.Config{}
serverCert, err = filepath.Abs(filepath.Join(certsDir, "server.pem"))
if err != nil {
return "", "", nil, fmt.Errorf("failed to get server cert path: %w", err)
}
serverKey, err = filepath.Abs(filepath.Join(certsDir, "server-key.pem"))
if err != nil {
return "", "", nil, fmt.Errorf("failed to get server key path: %w", err)
}
b, err := os.ReadFile(filepath.Join(certsDir, "ca.pem"))
if err != nil {
return "", "", nil, fmt.Errorf("failed to load CA: %w", err)
}
caPool := x509.NewCertPool()
if !caPool.AppendCertsFromPEM(b) {
return "", "", nil, errors.New("failed to append CA to pool")
}
clientConf.RootCAs = caPool
clientCert := filepath.Join(certsDir, "client.pem")
clientKey := filepath.Join(certsDir, "client-key.pem")
client, err := tls.LoadX509KeyPair(clientCert, clientKey)
if err != nil {
return "", "", nil, fmt.Errorf("failed to load client cert and key: %w", err)
}
clientConf.Certificates = []tls.Certificate{client}
return
}