mirror of
				https://github.com/fluxcd/flux2.git
				synced 2025-11-04 11:56:11 +08:00 
			
		
		
		
	
		
			
				
	
	
		
			267 lines
		
	
	
		
			7.9 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			267 lines
		
	
	
		
			7.9 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
/*
 | 
						|
Copyright 2020 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 main
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"fmt"
 | 
						|
	"io/ioutil"
 | 
						|
	"net/url"
 | 
						|
	"os"
 | 
						|
	"path"
 | 
						|
	"regexp"
 | 
						|
	"time"
 | 
						|
 | 
						|
	"github.com/spf13/cobra"
 | 
						|
	corev1 "k8s.io/api/core/v1"
 | 
						|
	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 | 
						|
 | 
						|
	"github.com/fluxcd/pkg/git"
 | 
						|
 | 
						|
	"github.com/fluxcd/flux2/internal/flags"
 | 
						|
	"github.com/fluxcd/flux2/internal/utils"
 | 
						|
)
 | 
						|
 | 
						|
var bootstrapGitLabCmd = &cobra.Command{
 | 
						|
	Use:   "gitlab",
 | 
						|
	Short: "Bootstrap toolkit components in a GitLab repository",
 | 
						|
	Long: `The bootstrap gitlab command creates the GitLab repository if it doesn't exists and
 | 
						|
commits the toolkit components manifests to the master branch.
 | 
						|
Then it configures the target cluster to synchronize with the repository.
 | 
						|
If the toolkit components are present on the cluster,
 | 
						|
the bootstrap command will perform an upgrade if needed.`,
 | 
						|
	Example: `  # Create a GitLab API token and export it as an env var
 | 
						|
  export GITLAB_TOKEN=<my-token>
 | 
						|
 | 
						|
  # Run bootstrap for a private repo using HTTPS token authentication 
 | 
						|
  flux bootstrap gitlab --owner=<group> --repository=<repo name> --token-auth
 | 
						|
 | 
						|
  # Run bootstrap for a private repo using SSH authentication
 | 
						|
  flux bootstrap gitlab --owner=<group> --repository=<repo name>
 | 
						|
 | 
						|
  # Run bootstrap for a repository path
 | 
						|
  flux bootstrap gitlab --owner=<group> --repository=<repo name> --path=dev-cluster
 | 
						|
 | 
						|
  # Run bootstrap for a public repository on a personal account
 | 
						|
  flux bootstrap gitlab --owner=<user> --repository=<repo name> --private=false --personal --token-auth
 | 
						|
 | 
						|
  # Run bootstrap for a private repo hosted on a GitLab server 
 | 
						|
  flux bootstrap gitlab --owner=<group> --repository=<repo name> --hostname=<domain> --token-auth
 | 
						|
 | 
						|
  # Run bootstrap for a an existing repository with a branch named main
 | 
						|
  flux bootstrap gitlab --owner=<organization> --repository=<repo name> --branch=main --token-auth
 | 
						|
`,
 | 
						|
	RunE: bootstrapGitLabCmdRun,
 | 
						|
}
 | 
						|
 | 
						|
const (
 | 
						|
	gitlabProjectRegex = `\A[[:alnum:]\x{00A9}-\x{1f9ff}_][[:alnum:]\p{Pd}\x{00A9}-\x{1f9ff}_\.]*\z`
 | 
						|
)
 | 
						|
 | 
						|
var (
 | 
						|
	glOwner       string
 | 
						|
	glRepository  string
 | 
						|
	glInterval    time.Duration
 | 
						|
	glPersonal    bool
 | 
						|
	glPrivate     bool
 | 
						|
	glHostname    string
 | 
						|
	glSSHHostname string
 | 
						|
	glPath        flags.SafeRelativePath
 | 
						|
)
 | 
						|
 | 
						|
func init() {
 | 
						|
	bootstrapGitLabCmd.Flags().StringVar(&glOwner, "owner", "", "GitLab user or group name")
 | 
						|
	bootstrapGitLabCmd.Flags().StringVar(&glRepository, "repository", "", "GitLab repository name")
 | 
						|
	bootstrapGitLabCmd.Flags().BoolVar(&glPersonal, "personal", false, "is personal repository")
 | 
						|
	bootstrapGitLabCmd.Flags().BoolVar(&glPrivate, "private", true, "is private repository")
 | 
						|
	bootstrapGitLabCmd.Flags().DurationVar(&glInterval, "interval", time.Minute, "sync interval")
 | 
						|
	bootstrapGitLabCmd.Flags().StringVar(&glHostname, "hostname", git.GitLabDefaultHostname, "GitLab hostname")
 | 
						|
	bootstrapGitLabCmd.Flags().StringVar(&glSSHHostname, "ssh-hostname", "", "GitLab SSH hostname, to be used when the SSH host differs from the HTTPS one")
 | 
						|
	bootstrapGitLabCmd.Flags().Var(&glPath, "path", "path relative to the repository root, when specified the cluster sync will be scoped to this path")
 | 
						|
 | 
						|
	bootstrapCmd.AddCommand(bootstrapGitLabCmd)
 | 
						|
}
 | 
						|
 | 
						|
func bootstrapGitLabCmdRun(cmd *cobra.Command, args []string) error {
 | 
						|
	glToken := os.Getenv(git.GitLabTokenName)
 | 
						|
	if glToken == "" {
 | 
						|
		return fmt.Errorf("%s environment variable not found", git.GitLabTokenName)
 | 
						|
	}
 | 
						|
 | 
						|
	projectNameIsValid, err := regexp.MatchString(gitlabProjectRegex, glRepository)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
	if !projectNameIsValid {
 | 
						|
		return fmt.Errorf("%s is an invalid project name for gitlab.\nIt can contain only letters, digits, emojis, '_', '.', dash, space. It must start with letter, digit, emoji or '_'.", glRepository)
 | 
						|
	}
 | 
						|
 | 
						|
	if err := bootstrapValidate(); err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	repository, err := git.NewRepository(glRepository, glOwner, glHostname, glToken, "flux", glOwner+"@users.noreply.gitlab.com")
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	if glSSHHostname != "" {
 | 
						|
		repository.SSHHost = glSSHHostname
 | 
						|
	}
 | 
						|
 | 
						|
	provider := &git.GitLabProvider{
 | 
						|
		IsPrivate:  glPrivate,
 | 
						|
		IsPersonal: glPersonal,
 | 
						|
	}
 | 
						|
 | 
						|
	kubeClient, err := utils.KubeClient(kubeconfig, kubecontext)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	tmpDir, err := ioutil.TempDir("", namespace)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
	defer os.RemoveAll(tmpDir)
 | 
						|
 | 
						|
	ctx, cancel := context.WithTimeout(context.Background(), timeout)
 | 
						|
	defer cancel()
 | 
						|
 | 
						|
	// create GitLab project if doesn't exists
 | 
						|
	logger.Actionf("connecting to %s", glHostname)
 | 
						|
	changed, err := provider.CreateRepository(ctx, repository)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
	if changed {
 | 
						|
		logger.Successf("repository created")
 | 
						|
	}
 | 
						|
 | 
						|
	// clone repository and checkout the master branch
 | 
						|
	if err := repository.Checkout(ctx, bootstrapBranch, tmpDir); err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
	logger.Successf("repository cloned")
 | 
						|
 | 
						|
	// generate install manifests
 | 
						|
	logger.Generatef("generating manifests")
 | 
						|
	installManifest, err := generateInstallManifests(glPath.String(), namespace, tmpDir, bootstrapManifestsPath)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	// stage install manifests
 | 
						|
	changed, err = repository.Commit(ctx, path.Join(glPath.String(), namespace), "Add manifests")
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	// push install manifests
 | 
						|
	if changed {
 | 
						|
		if err := repository.Push(ctx); err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
		logger.Successf("components manifests pushed")
 | 
						|
	} else {
 | 
						|
		logger.Successf("components are up to date")
 | 
						|
	}
 | 
						|
 | 
						|
	// determine if repo synchronization is working
 | 
						|
	isInstall := shouldInstallManifests(ctx, kubeClient, namespace)
 | 
						|
 | 
						|
	if isInstall {
 | 
						|
		// apply install manifests
 | 
						|
		logger.Actionf("installing components in %s namespace", namespace)
 | 
						|
		if err := applyInstallManifests(ctx, installManifest, bootstrapComponents()); err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
		logger.Successf("install completed")
 | 
						|
	}
 | 
						|
 | 
						|
	repoURL := repository.GetURL()
 | 
						|
 | 
						|
	if bootstrapTokenAuth {
 | 
						|
		// setup HTTPS token auth
 | 
						|
		secret := corev1.Secret{
 | 
						|
			ObjectMeta: metav1.ObjectMeta{
 | 
						|
				Name:      namespace,
 | 
						|
				Namespace: namespace,
 | 
						|
			},
 | 
						|
			StringData: map[string]string{
 | 
						|
				"username": "git",
 | 
						|
				"password": glToken,
 | 
						|
			},
 | 
						|
		}
 | 
						|
		if err := upsertSecret(ctx, kubeClient, secret); err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
	} else {
 | 
						|
		// setup SSH deploy key
 | 
						|
		repoURL = repository.GetSSH()
 | 
						|
		if shouldCreateDeployKey(ctx, kubeClient, namespace) {
 | 
						|
			logger.Actionf("configuring deploy key")
 | 
						|
			u, err := url.Parse(repoURL)
 | 
						|
			if err != nil {
 | 
						|
				return fmt.Errorf("git URL parse failed: %w", err)
 | 
						|
			}
 | 
						|
 | 
						|
			key, err := generateDeployKey(ctx, kubeClient, u, namespace)
 | 
						|
			if err != nil {
 | 
						|
				return fmt.Errorf("generating deploy key failed: %w", err)
 | 
						|
			}
 | 
						|
 | 
						|
			keyName := "flux"
 | 
						|
			if glPath != "" {
 | 
						|
				keyName = fmt.Sprintf("flux-%s", glPath)
 | 
						|
			}
 | 
						|
 | 
						|
			if changed, err := provider.AddDeployKey(ctx, repository, key, keyName); err != nil {
 | 
						|
				return err
 | 
						|
			} else if changed {
 | 
						|
				logger.Successf("deploy key configured")
 | 
						|
			}
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	// configure repo synchronization
 | 
						|
	logger.Actionf("generating sync manifests")
 | 
						|
	syncManifests, err := generateSyncManifests(repoURL, bootstrapBranch, namespace, namespace, glPath.String(), tmpDir, glInterval)
 | 
						|
	if err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	// commit and push manifests
 | 
						|
	if changed, err = repository.Commit(ctx, path.Join(glPath.String(), namespace), "Add manifests"); err != nil {
 | 
						|
		return err
 | 
						|
	} else if changed {
 | 
						|
		if err := repository.Push(ctx); err != nil {
 | 
						|
			return err
 | 
						|
		}
 | 
						|
		logger.Successf("sync manifests pushed")
 | 
						|
	}
 | 
						|
 | 
						|
	// apply manifests and waiting for sync
 | 
						|
	logger.Actionf("applying sync manifests")
 | 
						|
	if err := applySyncManifests(ctx, kubeClient, namespace, namespace, syncManifests); err != nil {
 | 
						|
		return err
 | 
						|
	}
 | 
						|
 | 
						|
	logger.Successf("bootstrap finished")
 | 
						|
	return nil
 | 
						|
}
 |