Files
argo-cd/util/cli/cli.go
2026-02-12 09:29:40 -05:00

349 lines
10 KiB
Go

// Package cmd provides functionally common to various argo CLIs
package cli
import (
"bufio"
"bytes"
"context"
stderrors "errors"
"flag"
"fmt"
"os"
"os/exec"
"path"
"strconv"
"strings"
"github.com/argoproj/argo-cd/gitops-engine/pkg/utils/text"
"github.com/google/shlex"
log "github.com/sirupsen/logrus"
"github.com/spf13/cobra"
"github.com/spf13/pflag"
terminal "golang.org/x/term"
"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
"k8s.io/client-go/tools/clientcmd"
"k8s.io/klog/v2"
"k8s.io/kubectl/pkg/util/term"
"sigs.k8s.io/yaml"
"github.com/argoproj/argo-cd/v3/common"
"github.com/argoproj/argo-cd/v3/util/errors"
utilio "github.com/argoproj/argo-cd/v3/util/io"
utillog "github.com/argoproj/argo-cd/v3/util/log"
)
// NewVersionCmd returns a new `version` command to be used as a sub-command to root
func NewVersionCmd(cliName string) *cobra.Command {
var short bool
versionCmd := cobra.Command{
Use: "version",
Short: "Print version information",
Run: func(_ *cobra.Command, _ []string) {
version := common.GetVersion()
fmt.Printf("%s: %s\n", cliName, version)
if short {
return
}
fmt.Printf(" BuildDate: %s\n", version.BuildDate)
fmt.Printf(" GitCommit: %s\n", version.GitCommit)
fmt.Printf(" GitTreeState: %s\n", version.GitTreeState)
if version.GitTag != "" {
fmt.Printf(" GitTag: %s\n", version.GitTag)
}
fmt.Printf(" GoVersion: %s\n", version.GoVersion)
fmt.Printf(" Compiler: %s\n", version.Compiler)
fmt.Printf(" Platform: %s\n", version.Platform)
if version.ExtraBuildInfo != "" {
fmt.Printf(" ExtraBuildInfo: %s\n", version.ExtraBuildInfo)
}
},
}
versionCmd.Flags().BoolVar(&short, "short", false, "print just the version number")
return &versionCmd
}
// AddKubectlFlagsToCmd adds kubectl like flags to a persistent flags of a command and returns the ClientConfig interface
// for retrieving the values.
func AddKubectlFlagsToCmd(cmd *cobra.Command) clientcmd.ClientConfig {
return AddKubectlFlagsToSet(cmd.PersistentFlags())
}
// AddKubectlFlagsToSet adds kubectl like flags to a provided flag set and returns the ClientConfig interface
// for retrieving the values.
func AddKubectlFlagsToSet(flags *pflag.FlagSet) clientcmd.ClientConfig {
loadingRules := clientcmd.NewDefaultClientConfigLoadingRules()
loadingRules.DefaultClientConfig = &clientcmd.DefaultClientConfig
overrides := clientcmd.ConfigOverrides{}
kflags := clientcmd.RecommendedConfigOverrideFlags("")
flags.StringVar(&loadingRules.ExplicitPath, "kubeconfig", "", "Path to a kube config. Only required if out-of-cluster")
clientcmd.BindOverrideFlags(&overrides, flags, kflags)
return clientcmd.NewInteractiveDeferredLoadingClientConfig(loadingRules, &overrides, os.Stdin)
}
// PromptCredentials is a helper to prompt the user for a username and password (unless already supplied)
func PromptCredentials(username, password string) (string, string) {
return PromptUsername(username), PromptPassword(password)
}
// PromptUsername prompts the user for a username value
func PromptUsername(username string) string {
return PromptMessage("Username", username)
}
// PromptMessage prompts the user for a value (unless already supplied)
func PromptMessage(message, value string) string {
for value == "" {
reader := bufio.NewReader(os.Stdin)
fmt.Print(message + ": ")
valueRaw, err := reader.ReadString('\n')
errors.CheckError(err)
value = strings.TrimSpace(valueRaw)
}
return value
}
// PromptPassword prompts the user for a password, without local echo (unless already supplied).
// If terminal.ReadPassword fails — often due to stdin not being a terminal (e.g., when input is piped),
// we fall back to reading from standard input using bufio.Reader.
func PromptPassword(password string) string {
for password == "" {
fmt.Print("Password: ")
passwordRaw, err := terminal.ReadPassword(int(os.Stdin.Fd()))
if err != nil {
// Fallback: handle cases where stdin is not a terminal (e.g., piped input)
reader := bufio.NewReader(os.Stdin)
input, err := reader.ReadString('\n')
errors.CheckError(err)
password = strings.TrimSpace(input)
return password
}
password = string(passwordRaw)
fmt.Print("\n")
}
return password
}
// AskToProceed prompts the user with a message (typically a yes or no question) and returns whether
// they responded in the affirmative or negative.
func AskToProceed(message string) bool {
for {
fmt.Print(message)
reader := bufio.NewReader(os.Stdin)
proceedRaw, err := reader.ReadString('\n')
errors.CheckError(err)
switch strings.ToLower(strings.TrimSpace(proceedRaw)) {
case "y", "yes":
return true
case "n", "no":
return false
}
}
}
// AskToProceedS prompts the user with a message (typically a yes, no or all question) and returns string
// "a", "y" or "n".
func AskToProceedS(message string) string {
for {
fmt.Print(message)
reader := bufio.NewReader(os.Stdin)
proceedRaw, err := reader.ReadString('\n')
errors.CheckError(err)
switch strings.ToLower(strings.TrimSpace(proceedRaw)) {
case "y", "yes":
return "y"
case "n", "no":
return "n"
case "a", "all":
return "a"
}
}
}
// ReadAndConfirmPassword is a helper to read and confirm a password from stdin
func ReadAndConfirmPassword(username string) (string, error) {
for {
fmt.Printf("*** Enter new password for user %s: ", username)
password, err := terminal.ReadPassword(int(os.Stdin.Fd()))
if err != nil {
return "", err
}
fmt.Print("\n")
fmt.Printf("*** Confirm new password for user %s: ", username)
confirmPassword, err := terminal.ReadPassword(int(os.Stdin.Fd()))
if err != nil {
return "", err
}
fmt.Print("\n")
if bytes.Equal(password, confirmPassword) {
return string(password), nil
}
log.Error("Passwords do not match")
}
}
// SetLogFormat sets a logrus log format
func SetLogFormat(logFormat string) {
switch strings.ToLower(logFormat) {
case utillog.JsonFormat:
os.Setenv(common.EnvLogFormat, utillog.JsonFormat)
case utillog.TextFormat, "":
os.Setenv(common.EnvLogFormat, utillog.TextFormat)
default:
log.Fatalf("Unknown log format '%s'", logFormat)
}
log.SetFormatter(utillog.CreateFormatter(logFormat))
}
// SetLogLevel parses and sets a logrus log level
func SetLogLevel(logLevel string) {
level, err := log.ParseLevel(text.FirstNonEmpty(logLevel, log.InfoLevel.String()))
errors.CheckError(err)
os.Setenv(common.EnvLogLevel, level.String())
log.SetLevel(level)
}
// SetGLogLevel set the glog level for the k8s go-client
func SetGLogLevel(glogLevel int) {
klog.InitFlags(nil)
_ = flag.Set("logtostderr", "true")
_ = flag.Set("v", strconv.Itoa(glogLevel))
}
func writeToTempFile(pattern string, data []byte) string {
f, err := os.CreateTemp("", pattern)
errors.CheckError(err)
defer utilio.Close(f)
_, err = f.Write(data)
errors.CheckError(err)
return f.Name()
}
func stripComments(input []byte) []byte {
var stripped []byte
lines := bytes.Split(input, []byte("\n"))
for i, line := range lines {
if bytes.HasPrefix(bytes.TrimSpace(line), []byte("#")) {
continue
}
stripped = append(stripped, line...)
if i < len(lines)-1 {
stripped = append(stripped, '\n')
}
}
return stripped
}
const (
defaultEditor = "vi"
editorEnv = "EDITOR"
commentsHeader = `# Please edit the object below. Lines beginning with a '#' will be ignored,
# and an empty file will abort the edit. If an error occurs while saving this file will be
# reopened with the relevant failures."
`
)
func setComments(input []byte, comments string) []byte {
input = stripComments(input)
var commentLines []string
for line := range strings.SplitSeq(comments, "\n") {
if line != "" {
commentLines = append(commentLines, "# "+line)
}
}
parts := []string{commentsHeader}
if len(commentLines) > 0 {
parts = append(parts, strings.Join(commentLines, "\n"))
}
parts = append(parts, string(input))
return []byte(strings.Join(parts, "\n"))
}
// InteractiveEdit launches an interactive editor
func InteractiveEdit(filePattern string, data []byte, save func(input []byte) error) {
var editor string
var editorArgs []string
if overrideEditor := os.Getenv(editorEnv); overrideEditor == "" {
editor = defaultEditor
} else {
parts := strings.Fields(overrideEditor)
editor = parts[0]
editorArgs = parts[1:]
}
errorComment := ""
for {
data = setComments(data, errorComment)
tempFile := writeToTempFile(filePattern, data)
cmd := exec.CommandContext(context.Background(), editor, append(editorArgs, tempFile)...)
cmd.Stdout = os.Stdout
cmd.Stderr = os.Stderr
cmd.Stdin = os.Stdin
err := (term.TTY{In: os.Stdin, TryDev: true}).Safe(cmd.Run)
errors.CheckError(err)
updated, err := os.ReadFile(tempFile)
errors.CheckError(err)
if len(updated) == 0 || bytes.Equal(updated, data) {
errors.CheckError(stderrors.New("edit cancelled, no valid changes were saved"))
break
}
data = stripComments(updated)
err = save(data)
if err == nil {
break
}
errorComment = err.Error()
}
}
// PrintDiff prints a diff between two unstructured objects to stdout using an external diff utility
// Honors the diff utility set in the KUBECTL_EXTERNAL_DIFF environment variable
func PrintDiff(name string, live *unstructured.Unstructured, target *unstructured.Unstructured) error {
tempDir, err := os.MkdirTemp("", "argocd-diff")
if err != nil {
return err
}
targetFile := path.Join(tempDir, name)
targetData := []byte("")
if target != nil {
targetData, err = yaml.Marshal(target)
if err != nil {
return err
}
}
err = os.WriteFile(targetFile, targetData, 0o644)
if err != nil {
return err
}
liveFile := path.Join(tempDir, name+"-live.yaml")
liveData := []byte("")
if live != nil {
liveData, err = yaml.Marshal(live)
if err != nil {
return err
}
}
err = os.WriteFile(liveFile, liveData, 0o644)
if err != nil {
return err
}
cmdBinary := "diff"
var args []string
if envDiff := os.Getenv("KUBECTL_EXTERNAL_DIFF"); envDiff != "" {
parts, err := shlex.Split(envDiff)
if err != nil {
return err
}
cmdBinary = parts[0]
args = parts[1:]
}
cmd := exec.CommandContext(context.Background(), cmdBinary, append(args, liveFile, targetFile)...)
cmd.Stderr = os.Stderr
cmd.Stdout = os.Stdout
return cmd.Run()
}