mesh

README

# IstioOperator to Helm Migration

This folder contains auto-generated output from the `istioctl manifest translate` command.
Note the `manifest translate` command only outputs this folders contents, and does not modify the cluster state.

Follow the instructions below for each component to complete the migration.

# Components
{{- range $c := .Results }}
{{$c}}
{{- end}}

Documentation

Overview

Package mesh contains types and functions.

Index

• Constants
• Variables
• func Confirm(msg string, writer io.Writer) bool
• func GetTagVersion(tagInfo string) (string, error)
• func Install(kubeClient kube.CLIClient, rootArgs *RootArgs, iArgs *InstallArgs, ...) error
• func InstallCmd(ctx cli.Context) *cobra.Command
• func InstallCmdWithArgs(ctx cli.Context, rootArgs *RootArgs, iArgs *InstallArgs) *cobra.Command
• func ManifestCmd(ctx cli.Context) *cobra.Command
• func ManifestGenerate(kubeClient kube.CLIClient, mgArgs *ManifestGenerateArgs, l clog.Logger) error
• func ManifestGenerateCmd(ctx cli.Context, _ *RootArgs, mgArgs *ManifestGenerateArgs) *cobra.Command
• func ManifestTranslate(kubeClient kube.CLIClient, mgArgs *ManifestTranslateArgs, l clog.Logger) error
• func ManifestTranslateCmd(ctx cli.Context, mgArgs *ManifestTranslateArgs) *cobra.Command
• func UninstallCmd(ctx cli.Context) *cobra.Command
• func UpgradeCmd(ctx cli.Context) *cobra.Command
• type InstallArgs
  • func (a *InstallArgs) String() string
• type ManifestGenerateArgs
  • func (a *ManifestGenerateArgs) String() string
• type ManifestTranslateArgs
• type Printer
  • func NewPrinterForWriter(w io.Writer) Printer
• type RootArgs

Constants

const (
	ChartsDeprecatedStr = "Deprecated, use --manifests instead."

	ForceFlagHelpStr       = `Proceed even with validation errors.`
	VerifyCRInstallHelpStr = "Verify the Istio control plane after installation/in-place upgrade"
)

const (
	AllResourcesRemovedWarning = "All Istio resources will be pruned from the cluster\n"
	NoResourcesRemovedWarning  = "No resources will be pruned from the cluster. Please double check the input configs\n"
	GatewaysRemovedWarning     = "You are about to remove the following gateways: %s." +
		" To avoid downtime, please quit this command and reinstall the gateway(s) with a revision that is not being removed from the cluster.\n"
	PurgeWithRevisionOrOperatorSpecifiedWarning = "Purge uninstall will remove all Istio resources, ignoring the specified revision or operator file"
)

const (
	// YAMLSeparator is a separator for multi-document YAML files.
	YAMLSeparator = "\n---\n"
)

Variables

var (

	// ManifestsFlagHelpStr is the command line description for --manifests
	ManifestsFlagHelpStr = `Specify a path to a directory of charts and profiles
(e.g. ~/Downloads/istio-` + baseVersion + `/manifests).
`
)

Functions

func Confirm

func Confirm(msg string, writer io.Writer) bool

Confirm waits for a user to confirm with the supplied message.

func GetTagVersion

func GetTagVersion(tagInfo string) (string, error)

GetTagVersion returns istio tag version

func Install

func Install(kubeClient kube.CLIClient, rootArgs *RootArgs, iArgs *InstallArgs, stdOut io.Writer, l clog.Logger, p Printer,
) error

func InstallCmd

func InstallCmd(ctx cli.Context) *cobra.Command

InstallCmd generates an Istio install manifest and applies it to a cluster

func InstallCmdWithArgs

func InstallCmdWithArgs(ctx cli.Context, rootArgs *RootArgs, iArgs *InstallArgs) *cobra.Command

InstallCmdWithArgs generates an Istio install manifest and applies it to a cluster

func ManifestCmd

func ManifestCmd(ctx cli.Context) *cobra.Command

ManifestCmd is a group of commands related to manifest generation, installation, diffing and migration.

func ManifestGenerate

func ManifestGenerate(kubeClient kube.CLIClient, mgArgs *ManifestGenerateArgs, l clog.Logger) error

func ManifestGenerateCmd

func ManifestGenerateCmd(ctx cli.Context, _ *RootArgs, mgArgs *ManifestGenerateArgs) *cobra.Command

func ManifestTranslate

func ManifestTranslate(kubeClient kube.CLIClient, mgArgs *ManifestTranslateArgs, l clog.Logger) error

func ManifestTranslateCmd

func ManifestTranslateCmd(ctx cli.Context, mgArgs *ManifestTranslateArgs) *cobra.Command

func UninstallCmd

func UninstallCmd(ctx cli.Context) *cobra.Command

UninstallCmd command uninstalls Istio from a cluster

func UpgradeCmd

func UpgradeCmd(ctx cli.Context) *cobra.Command

UpgradeCmd upgrades Istio control plane in-place with eligibility checks.

Types

type InstallArgs

type InstallArgs struct {
	// InFilenames is an array of paths to the input IstioOperator CR files.
	InFilenames []string
	// ReadinessTimeout is maximum time to wait for all Istio resources to be ready. wait must be true for this setting
	// to take effect.
	ReadinessTimeout time.Duration
	// SkipConfirmation determines whether the user is prompted for confirmation.
	// If set to true, the user is not prompted and a Yes response is assumed in all cases.
	SkipConfirmation bool
	// Force proceeds even if there are validation errors
	Force bool
	// Verify after installation
	Verify bool
	// Set is a string with element format "path=value" where path is an IstioOperator path and the value is a
	// value to set the node at that path to.
	Set []string
	// ManifestsPath is a path to a ManifestsPath and profiles directory in the local filesystem with a release tgz.
	ManifestsPath string
	// Revision is the Istio control plane revision the command targets.
	Revision string
}

func (*InstallArgs) String

func (a *InstallArgs) String() string

type ManifestGenerateArgs

type ManifestGenerateArgs struct {
	// InFilenames is an array of paths to the input IstioOperator CR files.
	InFilenames []string

	// EnableClusterSpecific determines if the current Kubernetes cluster will be used to autodetect values.
	// If false, generic defaults will be used. This is useful when generating once and then applying later.
	EnableClusterSpecific bool

	// Set is a string with element format "path=value" where path is an IstioOperator path and the value is a
	// value to set the node at that path to.
	Set []string
	// Force proceeds even if there are validation errors
	Force bool
	// ManifestsPath is a path to a charts and profiles directory in the local filesystem with a release tgz.
	ManifestsPath string
	// Revision is the Istio control plane revision the command targets.
	Revision string
	// Filter is the list of components to render
	Filter []string
}

func (*ManifestGenerateArgs) String

func (a *ManifestGenerateArgs) String() string

type ManifestTranslateArgs

type ManifestTranslateArgs struct {
	// InFilenames is an array of paths to the input IstioOperator CR files.
	InFilenames []string

	// Set is a string with element format "path=value" where path is an IstioOperator path and the value is a
	// value to set the node at that path to.
	Set []string
	// ManifestsPath is a path to a charts and profiles directory in the local filesystem with a release tgz.
	ManifestsPath string
	// Revision is the Istio control plane revision the command targets.
	Revision string

	// Output path to print out instructions and configurations
	Output string
}

type Printer

type Printer interface {
	Printf(format string, a ...any)
	Println(string)
}

func NewPrinterForWriter

func NewPrinterForWriter(w io.Writer) Printer

type RootArgs

type RootArgs struct {
	// DryRun performs all steps except actually applying the manifests or creating output dirs/files.
	DryRun bool
}