projects

Documentation

Overview

Package projects contains utilities for working with projects.

Index

• Constants
• Variables
• func SerializeMetadata(meta *Metadata) ([]byte, error)
• type Metadata
  • func NewSelfEnrolledMetadata(projectName string) Metadata
  • func ParseMetadata(proj *db.Project) (*Metadata, error)
• type ProjectCreator
  • func NewProjectCreator(authzClient authz.Client, marketplace marketplaces.Marketplace, ...) ProjectCreator
• type ProjectDeleter
  • func NewProjectDeleter(authzClient authz.Client, providerManager manager.ProviderManager) ProjectDeleter
• type PublicMetadataV1

Constants

const (
	// MinderMetadataVersion is the version of the metadata format.
	MinderMetadataVersion = "v1alpha1"
)

Variables

var (
	// ErrProjectAlreadyExists is returned when a project with the same name already exists
	ErrProjectAlreadyExists = errors.New("project already exists")
)

Functions

func SerializeMetadata

func SerializeMetadata(meta *Metadata) ([]byte, error)

SerializeMetadata serializes the given Metadata object into JSON.

Types

type Metadata

type Metadata struct {
	Version      string `json:"version"`
	SelfEnrolled bool   `json:"self_enrolled"`

	// This will be deprecated in favor of PublicMetadataV1.
	Description string `json:"description"`

	// Public is a field that is meant to be read by other systems.
	// It will be exposed to the public, e.g. via a UI.
	Public PublicMetadataV1 `json:"public"`
}

Metadata contains metadata relevant for a project.

func NewSelfEnrolledMetadata

func NewSelfEnrolledMetadata(projectName string) Metadata

NewSelfEnrolledMetadata returns a new Metadata object with the SelfEnrolled field set to true.

func ParseMetadata

func ParseMetadata(proj *db.Project) (*Metadata, error)

ParseMetadata parses the given JSON data into a Metadata object.

type ProjectCreator

type ProjectCreator interface {
	// ProvisionSelfEnrolledOAuthProject creates the default records, such as projects,
	// roles and provider for the organization
	ProvisionSelfEnrolledOAuthProject(
		ctx context.Context,
		qtx db.Querier,
		projectName string,
		userSub string,
	) (outproj *db.Project, projerr error)

	// ProvisionSelfEnrolledProject creates the core default components of the project
	// (project, marketplace subscriptions, etc.) but *does not* create a project.
	ProvisionSelfEnrolledProject(
		ctx context.Context,
		qtx db.Querier,
		projectName string,
		userSub string,
	) (outproj *db.Project, projerr error)
}

ProjectCreator encapsulates operations for managing projects TODO: There are several follow-ups needed here: 1. Move the delete operations into this interface 2. The interface is very GitHub-specific. It needs to be made more generic.

func NewProjectCreator

func NewProjectCreator(authzClient authz.Client,
	marketplace marketplaces.Marketplace,
	profilesCfg *server.DefaultProfilesConfig,
) ProjectCreator

NewProjectCreator creates a new instance of the project creator

type ProjectDeleter

type ProjectDeleter interface {
	// CleanUpUnmanagedProjects deletes a project if it has no role assignments left
	CleanUpUnmanagedProjects(
		ctx context.Context,
		subject string,
		proj uuid.UUID,
		querier db.Querier,
	) error

	// DeleteProject deletes a project and authorization relationships
	DeleteProject(
		ctx context.Context,
		proj uuid.UUID,
		querier db.Querier,
	) error
}

ProjectDeleter encapsulates operations for deleting projects This is a separate interface/struct to ProjectCreator to avoid a circular dependency issue.

func NewProjectDeleter

func NewProjectDeleter(
	authzClient authz.Client,
	providerManager manager.ProviderManager,
) ProjectDeleter

NewProjectDeleter creates a new instance of the project deleter

type PublicMetadataV1

type PublicMetadataV1 struct {
	Description string `json:"description"`
	DisplayName string `json:"display_name"`
}

PublicMetadataV1 contains public metadata relevant for a project.