client/pkg/commands/wait_flags.go

60 lines
2.4 KiB
Go

// Copyright © 2019 The Knative 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 commands
import (
"fmt"
"github.com/spf13/cobra"
knflags "knative.dev/client/pkg/flags"
)
// Default time out to use when waiting for reconciliation. It is deliberately very long as it is expected that
// the service doesn't stay in `Unknown` status very long and eventually ends up as `False` or `True` in a timely
// manner
const WaitDefaultTimeout = 600
// Flags for tuning wait behaviour
type WaitFlags struct {
// Timeout in seconds for how long to wait for a command to return
TimeoutInSeconds int
// If set then apply resources and wait for completion
Wait bool
// Duration in seconds for waiting between intermediate false ready conditions
ErrorWindowInSeconds int
}
// Add flags which influence the wait/no-wait behaviour when creating, updating, waiting for
// resources. If the action is not `wait`, set `waitDefault` argument if the default behaviour is synchronous.
// Use `what` for describing what is waited for.
func (p *WaitFlags) AddConditionWaitFlags(command *cobra.Command, waitTimeoutDefault int, action, what, until string) {
if action != "wait" {
waitUsage := fmt.Sprintf("Wait for '%s %s' operation to be completed.", what, action)
waitDefault := true
// Special-case 'delete' command so it comes back to the user immediately
if action == "delete" {
waitDefault = false
}
knflags.AddBothBoolFlagsUnhidden(command.Flags(), &p.Wait, "wait", "", waitDefault, waitUsage)
}
timeoutUsage := fmt.Sprintf("Seconds to wait before giving up on waiting for %s to be %s.", what, until)
command.Flags().IntVar(&p.TimeoutInSeconds, "wait-timeout", waitTimeoutDefault, timeoutUsage)
windowUsage := fmt.Sprintf("Seconds to wait for %s to be %s after a false ready condition is returned", what, until)
command.Flags().IntVar(&p.ErrorWindowInSeconds, "wait-window", 2, windowUsage)
}