✨ clusterctl: dump metadata.yaml when -v=10

Adds verbose logging of metadata.yaml content for GitHub-hosted providers when clusterctl is run with -v=10.

This enhances troubleshooting of release metadata without overwhelming the logs.

Author: kahirokunn

cmd/clusterctl/client/repository/repository_github.go

@@ -26,6 +26,7 @@ import (
 	"path"
 	"path/filepath"
 	"strings"
+	"sync"
 	"time"
 
 	"github.com/blang/semver/v4"
@@ -59,6 +60,9 @@ var (
 	cacheFiles                 = map[string][]byte{}
 	retryableOperationInterval = 10 * time.Second
 	retryableOperationTimeout  = 1 * time.Minute
+
+	// dumpedMetadata tracks which metadata files have already been dumped to avoid duplicates
+	dumpedMetadata             = sync.Map{}
 )
 
 // gitHubRepository provides support for providers hosted on GitHub.
@@ -494,6 +498,31 @@ func (g *gitHubRepository) downloadFilesFromRelease(ctx context.Context, release
 		return nil, retryError
 	}
 
+	// If this is a metadata.yaml file and verbose logging is enabled (-v=10), dump the content to logs
+	if filepath.Base(fileName) == "metadata.yaml" {
+		log := logf.Log
+		// Check if verbose logging is enabled by creating a V(10) logger and checking if it's enabled
+		verboseLog := log.V(10)
+		if verboseLog.Enabled() {
+			log.Info("Dumping metadata.yaml via downloadFilesFromRelease", "provider", g.providerConfig.Name(), "fileName", fileName)
+
+			// Create a unique key for this provider/version combination
+			version := ""
+			if release.TagName != nil {
+				version = *release.TagName
+			}
+			dumpKey := fmt.Sprintf("%s/%s/%s", g.providerConfig.Name(), g.providerConfig.Type(), version)
+
+			// Only dump if we haven't already dumped this metadata file
+			if _, alreadyDumped := dumpedMetadata.LoadOrStore(dumpKey, true); !alreadyDumped {
+				providerID := fmt.Sprintf("%s/%s", g.providerConfig.Name(), version)
+				verboseLog.Info("metadata.yaml content",
+					"providerID", providerID,
+					"content", string(content))
+			}
+		}
+	}
+
 	return content, nil
 }