Documentation ¶
Index ¶
- Constants
- func NoopCleanup()
- type ApplyPersistent
- type Args
- type Cleanup
- func SetupCloudFunctionsGen2(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- func SetupCloudRun(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- func SetupGae(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- func SetupGaeStandard(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- func SetupGce(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- func SetupGke(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- func SetupLocal(ctx context.Context, args *Args, logger *log.Logger) (*testclient.Client, Cleanup, error)
- type CloudFunctionsGen2Cmd
- type CloudRunCmd
- type CmdWithImage
- type CmdWithProjectId
- type GaeCmd
- type GaeStandardCmd
- type GceCmd
- type GkeCmd
- type LocalCmd
- type SetupFunc
Constants ¶
const BeginOutputArt = `` /* 908-byte string literal not displayed */
const EndOutputArt = `` /* 908-byte string literal not displayed */
Variables ¶
This section is empty.
Functions ¶
func NoopCleanup ¶
func NoopCleanup()
Types ¶
type ApplyPersistent ¶
type ApplyPersistent struct {
AutoApprove bool `arg:"--auto-approve" default:"false" help:"Approve without prompting. Default is false."`
}
type Args ¶
type Args struct { // This subcommand is a special case, it doesn't run any tests. It just // applies the persistent resources which are used across tests. See // tf/persistent/README.md for details on what is in there. ApplyPersistent *ApplyPersistent `arg:"subcommand:apply-persistent" help:"Terraform apply the resources in tf/persistent and exit (does not run tests)."` Local *LocalCmd `arg:"subcommand:local" help:"Deploy the test server locally with docker and execute tests"` Gke *GkeCmd `arg:"subcommand:gke" help:"Deploy the test server on GKE and execute tests"` Gce *GceCmd `arg:"subcommand:gce" help:"Deploy the test server on GCE and execute tests"` Gae *GaeCmd `arg:"subcommand:gae" help:"Deploy the test server on GAE and execute tests"` GaeStandard *GaeStandardCmd `arg:"subcommand:gae-standard" help:"Deploy the test server on GAE standard and execute tests"` CloudRun *CloudRunCmd `arg:"subcommand:cloud-run" help:"Deploy the test server on Cloud Run and execute tests"` CloudFunctionsGen2 *CloudFunctionsGen2Cmd `arg:"subcommand:cloud-functions-gen2" help:"Deploy the test server on Cloud Function (2nd Gen) and execute tests"` CmdWithProjectId GoTestFlags string `help:"go test flags to pass through, e.g. --gotestflags='-test.v'"` HealthCheckTimeout time.Duration `` /* 126-byte string literal not displayed */ // This is used in a new terraform workspace's name and in the GCP resources // we create. Pass the GCB build ID in CI to get the build id formatted into // resources created for debugging. If not provided, we generate a hex // string. TestRunID string `arg:"--test-run-id,env:TEST_RUN_ID" help:"Optional test run id to use to partition terraform resources"` }
type Cleanup ¶
type Cleanup func()
func SetupCloudFunctionsGen2 ¶ added in v0.14.0
func SetupCloudFunctionsGen2( ctx context.Context, args *Args, logger *log.Logger, ) (*testclient.Client, Cleanup, error)
SetupCloudFunctionsGen2 sets up the instrumented test server to run in Cloud Functions (2nd Gen). Creates a new Cloud Function and runs the specified source zip containing the code that needs to be run. The returned cleanup function tears down everything.
func SetupCloudRun ¶
func SetupCloudRun( ctx context.Context, args *Args, logger *log.Logger, ) (*testclient.Client, Cleanup, error)
SetupCloudRun sets up the instrumented test server to run in Cloud Run. Creates a new service and runs the specified container image as a revision. The returned cleanup function tears down everything.
func SetupGaeStandard ¶ added in v0.19.0
func SetupGce ¶
func SetupGce( ctx context.Context, args *Args, logger *log.Logger, ) (*testclient.Client, Cleanup, error)
Set up the instrumented test server to run in GCE container. Creates a new GCE VM + pubsub resources, and runs the specified container image. The returned cleanup function tears down the VM.
func SetupGke ¶
func SetupGke( ctx context.Context, args *Args, logger *log.Logger, ) (*testclient.Client, Cleanup, error)
Set up the instrumented test server to run in GKE. Creates a new GKE cluster and runs the specified container image in a pod. The returned cleanup function tears down the whole cluster.
type CloudFunctionsGen2Cmd ¶ added in v0.14.0
type CloudFunctionsGen2Cmd struct { // Needed to configure which language will the function instance support Runtime string `arg:"required" help:"Configure the language runtime environment for CloudFunction"` EntryPoint string `arg:"required" help:"The entry point for the code that will run in this CloudFunction"` FunctionSource string `arg:"required" help:"The full path of the zip file that contains the code source that needs to run within the CloudFunction"` }
type CloudRunCmd ¶
type CloudRunCmd struct {
CmdWithImage
}
type CmdWithImage ¶
type CmdWithImage struct {
Image string `arg:"required" help:"docker container image to deploy and test"`
}
type CmdWithProjectId ¶
type CmdWithProjectId struct {
ProjectID string `arg:"required,--project-id,env:PROJECT_ID" help:"GCP project id/name"`
}
type GaeCmd ¶ added in v0.15.0
type GaeCmd struct { CmdWithImage Runtime string `arg:"required" help:"The language runtime for the instrumented test server, used in naming the service"` }
type GaeStandardCmd ¶ added in v0.19.0
type GceCmd ¶
type GceCmd struct {
CmdWithImage
}
type GkeCmd ¶
type GkeCmd struct {
CmdWithImage
}
type LocalCmd ¶
type LocalCmd struct { CmdWithImage Port string `default:"8000"` // Needed when running without a metadata server for credentials GoogleApplicationCredentials string `` /* 152-byte string literal not displayed */ // May be needed when running this binary in a container Network string `help:"Docker network to use when starting the container, optional"` ContainerUser string `arg:"--container-user" help:"Optional user to use when running the container"` }