ociinstaller

Documentation

Index

• Constants
• func ConfigMediaTypes() []string
• func InstallDB(imageRef string, dest string) (string, error)
• func InstallFdw(imageRef string, dbLocation string) (string, error)
• func MediaTypeForPlatform(imageType string) string
• func NewOciDownloader(ctx context.Context) *ociDownloader
• func NewTempDir(path string) *tempDir
• func SharedMediaTypes(imageType string) []string
• type DbImage
• type HubImage
• type PluginImage
• type SteampipeImage
  • func InstallPlugin(imageRef string) (*SteampipeImage, error)
• type SteampipeImageRef
  • func NewSteampipeImageRef(ref string) *SteampipeImageRef
  • func (r *SteampipeImageRef) ActualImageRef() string
  • func (r *SteampipeImageRef) DisplayImageRef() string
  • func (r *SteampipeImageRef) GetOrgNameAndStream() (string, string, string)

Constants

const (
	DefaultImageTag            = "latest"
	DefaultImageRepoActualURL  = "us-docker.pkg.dev/steampipe"
	DefaultImageRepoDisplayURL = "hub.steampipe.io"

	DefaultImageOrg  = "turbot"
	DefaultImageType = "plugins"
)

const (
	MediaTypeConfig = "application/vnd.turbot.steampipe.config.v1+json"

	//deprecate this....
	MediaTypePluginConfig = "application/vnd.turbot.steampipe.plugin.config.v1+json"

	MediaTypePluginDarwinAmd64Layer  = "application/vnd.turbot.steampipe.plugin.darwin-amd64.layer.v1+gzip"
	MediaTypePluginLinuxAmd64Layer   = "application/vnd.turbot.steampipe.plugin.linux-amd64.layer.v1+gzip"
	MediaTypePluginWindowsAmd64Layer = "application/vnd.turbot.steampipe.plugin.windows-amd64.layer.v1+gzip"
	MediaTypePluginDarwinArm64Layer  = "application/vnd.turbot.steampipe.plugin.darwin-arm64.layer.v1+gzip"
	MediaTypePluginLinuxArm64Layer   = "application/vnd.turbot.steampipe.plugin.linux-arm64.layer.v1+gzip"
	MediaTypePluginWindowsArm64Layer = "application/vnd.turbot.steampipe.plugin.windows-arm64.layer.v1+gzip"
	MediaTypePluginLicenseLayer      = "application/vnd.turbot.steampipe.plugin.license.layer.v1+text"
	MediaTypePluginDocsLayer         = "application/vnd.turbot.steampipe.plugin.docs.layer.v1+tar"
	MediaTypePluginSpcLayer          = "application/vnd.turbot.steampipe.plugin.spc.layer.v1+tar"

	MediaTypeDbDarwinAmd64Layer  = "application/vnd.turbot.steampipe.db.darwin-amd64.layer.v1+tar"
	MediaTypeDbLinuxAmd64Layer   = "application/vnd.turbot.steampipe.db.linux-amd64.layer.v1+tar"
	MediaTypeDbWindowsAmd64Layer = "application/vnd.turbot.steampipe.db.windows-amd64.layer.v1+tar"
	MediaTypeDbDarwinArm64Layer  = "application/vnd.turbot.steampipe.db.darwin-arm64.layer.v1+tar"
	MediaTypeDbLinuxArm64Layer   = "application/vnd.turbot.steampipe.db.linux-arm64.layer.v1+tar"
	MediaTypeDbWindowsArm64Layer = "application/vnd.turbot.steampipe.db.windows-arm64.layer.v1+tar"
	MediaTypeDbDocLayer          = "application/vnd.turbot.steampipe.db.doc.layer.v1+text"
	MediaTypeDbLicenseLayer      = "application/vnd.turbot.steampipe.db.license.layer.v1+text"

	MediaTypeFdwDarwinAmd64Layer  = "application/vnd.turbot.steampipe.fdw.darwin-amd64.layer.v1+gzip"
	MediaTypeFdwLinuxAmd64Layer   = "application/vnd.turbot.steampipe.fdw.linux-amd64.layer.v1+gzip"
	MediaTypeFdwWindowsAmd64Layer = "application/vnd.turbot.steampipe.fdw.windows-amd64.layer.v1+gzip"
	MediaTypeFdwDarwinArm64Layer  = "application/vnd.turbot.steampipe.fdw.darwin-arm64.layer.v1+gzip"
	MediaTypeFdwLinuxArm64Layer   = "application/vnd.turbot.steampipe.fdw.linux-arm64.layer.v1+gzip"
	MediaTypeFdwWindowsArm64Layer = "application/vnd.turbot.steampipe.fdw.windows-arm64.layer.v1+gzip"
	MediaTypeFdwDocLayer          = "application/vnd.turbot.steampipe.fdw.doc.layer.v1+text"
	MediaTypeFdwLicenseLayer      = "application/vnd.turbot.steampipe.fdw.license.layer.v1+text"

	MediaTypeFdwControlLayer = "application/vnd.turbot.steampipe.fdw.control.layer.v1+text"
	MediaTypeFdwSqlLayer     = "application/vnd.turbot.steampipe.fdw.sql.layer.v1+text"
)

Steampipe Media Types

const DefaultConfigSchema string = "2020-11-18"

Functions

func ConfigMediaTypes

func ConfigMediaTypes() []string

ConfigMediaTypes :: returns media types for OCI $config data ( in the config, not a layer)

func InstallDB

func InstallDB(imageRef string, dest string) (string, error)

InstallDB :: Install Postgres files fom OCI image

func InstallFdw

func InstallFdw(imageRef string, dbLocation string) (string, error)

InstallFdw :: Install the Steampipe Hub Extension files from an OCI image

func MediaTypeForPlatform

func MediaTypeForPlatform(imageType string) string

MediaTypeForPlatform :: returns media types for binaries for this OS and architecture

func NewOciDownloader

func NewOciDownloader(ctx context.Context) *ociDownloader

NewOciDownloader :: creats and return a ociDownloader instance

func NewTempDir

func NewTempDir(path string) *tempDir

NewTempDir :: returns the temp directory, creating it if it does not exist

func SharedMediaTypes

func SharedMediaTypes(imageType string) []string

SharedMediaTypes :: Returns media types that are NOT specific to the os and arch (readmes, control files, etc)

Types

type DbImage

type DbImage struct {
	ArchiveDir  string
	ReadmeFile  string
	LicenseFile string
}

type HubImage

type HubImage struct {
	BinaryFile  string
	ReadmeFile  string
	LicenseFile string
	ControlFile string
	SqlFile     string
}

type PluginImage

type PluginImage struct {
	BinaryFile    string
	DocsDir       string
	ConfigFileDir string
	LicenseFile   string
}

type SteampipeImage

type SteampipeImage struct {
	OCIDescriptor *ocispec.Descriptor
	ImageRef      string
	Config        *config
	Plugin        *PluginImage
	Database      *DbImage
	Fdw           *HubImage
	// contains filtered or unexported fields
}

func InstallPlugin

func InstallPlugin(imageRef string) (*SteampipeImage, error)

InstallPlugin :: Install a plugin from an OCI Image

type SteampipeImageRef

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

SteampipeImageRef :: a ref to an OCI image

func NewSteampipeImageRef

func NewSteampipeImageRef(ref string) *SteampipeImageRef

NewSteampipeImageRef :: creates and returns a New SteampipeImageRef

func (*SteampipeImageRef) ActualImageRef

func (r *SteampipeImageRef) ActualImageRef() string

ActualImageRef :: returns the actual, physical full image ref (us-docker.pkg.dev/steampipe/plugins/turbot/aws:1.0.0)

func (*SteampipeImageRef) DisplayImageRef

func (r *SteampipeImageRef) DisplayImageRef() string

DisplayImageRef :: returns the "friendly" user-facing full image ref (hub.steampipe.io/plugins/turbot/aws@1.0.0)

func (*SteampipeImageRef) GetOrgNameAndStream

func (r *SteampipeImageRef) GetOrgNameAndStream() (string, string, string)

GetOrgNameAndStream :: splits the full image reference into (org, name, stream)