opensearch

Documentation

Index

• type OpenSearchContainer
  • func RunContainer(ctx context.Context, opts ...testcontainers.ContainerCustomizer) (*OpenSearchContainer, error)
  • func (c *OpenSearchContainer) Address(ctx context.Context) (string, error)
• type Option
  • func WithPassword(password string) Option
  • func WithUsername(username string) Option
  • func (o Option) Customize(*testcontainers.GenericContainerRequest)
• type Options

Examples

• RunContainer

Types

type OpenSearchContainer

type OpenSearchContainer struct {
	testcontainers.Container
	User     string
	Password string
}

OpenSearchContainer represents the OpenSearch container type used in the module

func RunContainer

func RunContainer(ctx context.Context, opts ...testcontainers.ContainerCustomizer) (*OpenSearchContainer, error)

RunContainer creates an instance of the OpenSearch container type

Example

// runOpenSearchContainer {
ctx := context.Background()

opensearchContainer, err := opensearch.RunContainer(
	ctx,
	testcontainers.WithImage("opensearchproject/opensearch:2.11.1"),
	opensearch.WithUsername("new-username"),
	opensearch.WithPassword("new-password"),
)
if err != nil {
	log.Fatalf("failed to start container: %s", err)
}

// Clean up the container
defer func() {
	if err := opensearchContainer.Terminate(ctx); err != nil {
		log.Fatalf("failed to terminate container: %s", err) // nolint:gocritic
	}
}()
// }

state, err := opensearchContainer.State(ctx)
if err != nil {
	log.Fatalf("failed to get container state: %s", err) // nolint:gocritic
}

fmt.Println(state.Running)
fmt.Printf("%s : %s\n", opensearchContainer.User, opensearchContainer.Password)

Output:

true
new-username : new-password

func (*OpenSearchContainer) Address

func (c *OpenSearchContainer) Address(ctx context.Context) (string, error)

Address retrieves the address of the OpenSearch container. It will use http as protocol, as TLS is not supported at the moment.

type Option

type Option func(*Options)

Option is an option for the OpenSearch container.

func WithPassword

func WithPassword(password string) Option

WithPassword sets the password for the OpenSearch container.

func WithUsername

func WithUsername(username string) Option

WithUsername sets the username for the OpenSearch container.

func (Option) Customize

func (o Option) Customize(*testcontainers.GenericContainerRequest)

Customize is a NOOP. It's defined to satisfy the testcontainers.ContainerCustomizer interface.

type Options

type Options struct {
	Password string
	Username string
}

Options is a struct for specifying options for the OpenSearch container.