devserver

Documentation

Overview

Package devserver provides in-process devserver implementations.

Index

• type Ephemeral
  • func NewEphemeral(lis net.Listener, cacheDir string, extraAllowedBuckets []string) (*Ephemeral, error)
  • func (e *Ephemeral) Close() error

Types

type Ephemeral

type Ephemeral struct {
	// contains filtered or unexported fields
}

Ephemeral is a minimal devserver implementation using local credentials.

An ephemeral devserver usually uses SSH reverse port forwarding to accept requests from local_test_runner on the DUT, and proxies requests to other servers such as Google Cloud Storage with proper credentials installed on the host. This allows unprivileged DUTs to access ACL'ed resources, such as private external data files on Google Cloud Storage.

func NewEphemeral

func NewEphemeral(lis net.Listener, cacheDir string, extraAllowedBuckets []string) (*Ephemeral, error)

NewEphemeral starts a new ephemeral devserver listening on lis. Ownership of lis is taken, so the caller must not call lis.Close. A directory is created at cacheDir if it does not exist.

func (*Ephemeral) Close

func (e *Ephemeral) Close() error

Close shuts down the ephemeral devserver and releases associated resources.