bulbistry

package module

v0.0.21 Latest Latest Go to latest Published: Dec 28, 2023 License: MIT Imports: 14 Imported by: 1

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/csjewell/bulbistry

Links

Open Source Insights

README ¶

Bulbistry

The name comes from Thomomys bulbivorus, the scientific name for the Camas pocket gopher, and the fact that this implements an OCI-compliant container registry.

The intention is to write a registry for (semi-)private small-scale use to be wrapped in a container. ONE container. Not 10, like Harbor does. Because of that, these requirements are set:

There is no requirement to use external services.
If you want HTTPS security, wrap a reverse proxy around this server.
The attached database is in SQLite format - no other databases will be supported until it DOES pass the spec.
Local storage only - if you want to hook up S3 or some other storage service, do it outside of this container.
This is implemented to the spec at https://github.com/opencontainers/distribution-spec/blob/main/spec.md, not to any specific program.
This is not a mirror. However, once it DOES pass the spec, we can talk about mirroring.
No support for vulnerability scanning will be entertained until it DOES pass the spec.

This is also my attempt to learn how to program in Go, as I've found that the best way for myself to learn is to read, and then try. I've been programming in Perl for years, but I'm willing to try other languages.

Because of that, this is a work-in-progress, and is woefully incomplete even as yet.

Documentation ¶

Index ¶

Constants
func ConfigError(w http.ResponseWriter, err error)
func GenerateBlobUUID(manifestName string, reference string) (string, error)
func GenerateManifestUUID(mt database.ManifestTag) (string, error)
func GetManifest(w http.ResponseWriter, _ *http.Request)
func GetNamespacedManifest(w http.ResponseWriter, _ *http.Request)
func GetNamespacedTags(w http.ResponseWriter, r *http.Request)
func GetRedirectManifest(w http.ResponseWriter, r *http.Request)
func GetRedirectNamespacedManifest(w http.ResponseWriter, r *http.Request)
func GetTags(w http.ResponseWriter, r *http.Request)
func GetV2Check(w http.ResponseWriter, _ *http.Request)
func HeadRedirectManifest(w http.ResponseWriter, r *http.Request)
func HeadRedirectNamespacedManifest(w http.ResponseWriter, r *http.Request)
func InvalidLogin(w http.ResponseWriter)
func NoLogin(w http.ResponseWriter)
func PostNamespacedBlobUpload(w http.ResponseWriter, r *http.Request)
func RepositoryNotFound(w http.ResponseWriter, name string)
func StoreInProgressUpload(namespace *string, name string, nano string)
func UploadLocation(namespace *string, name string, uuid uuid.UUID) string
type BasicAuth
- func NewBasicAuthMiddleware(authRequired bool, authorizer *htpasswd.File) BasicAuth
- func (ba *BasicAuth) Middleware(next http.Handler) http.Handler
type ErrorInfo
type Logger
- func NewLogger(w io.Writer, logUUID *uuid.UUID) *Logger
type ResponseText
type UnauthorizedDetails

Constants ¶

View Source

const (
	ConfigKey contextKey = iota
)

Variables ¶

This section is empty.

Functions ¶

func ConfigError ¶

func ConfigError(w http.ResponseWriter, err error)

func GenerateBlobUUID ¶

func GenerateBlobUUID(manifestName string, reference string) (string, error)

func GenerateManifestUUID ¶

func GenerateManifestUUID(mt database.ManifestTag) (string, error)

func GetManifest ¶

func GetManifest(w http.ResponseWriter, _ *http.Request)

func GetNamespacedManifest ¶

func GetNamespacedManifest(w http.ResponseWriter, _ *http.Request)

func GetNamespacedTags ¶

func GetNamespacedTags(w http.ResponseWriter, r *http.Request)

func GetRedirectManifest ¶

func GetRedirectManifest(w http.ResponseWriter, r *http.Request)

func GetRedirectNamespacedManifest ¶

func GetRedirectNamespacedManifest(w http.ResponseWriter, r *http.Request)

func GetTags ¶

func GetTags(w http.ResponseWriter, r *http.Request)

func GetV2Check ¶

func GetV2Check(w http.ResponseWriter, _ *http.Request)

func HeadRedirectManifest ¶

func HeadRedirectManifest(w http.ResponseWriter, r *http.Request)

func HeadRedirectNamespacedManifest ¶

func HeadRedirectNamespacedManifest(w http.ResponseWriter, r *http.Request)

func InvalidLogin ¶

func InvalidLogin(w http.ResponseWriter)

func NoLogin ¶

func NoLogin(w http.ResponseWriter)

func PostNamespacedBlobUpload ¶

func PostNamespacedBlobUpload(w http.ResponseWriter, r *http.Request)

func RepositoryNotFound ¶

func RepositoryNotFound(w http.ResponseWriter, name string)

func StoreInProgressUpload ¶

func StoreInProgressUpload(namespace *string, name string, nano string)

func UploadLocation ¶

func UploadLocation(namespace *string, name string, uuid uuid.UUID) string

Types ¶

type BasicAuth ¶

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

func NewBasicAuthMiddleware ¶

func NewBasicAuthMiddleware(authRequired bool, authorizer *htpasswd.File) BasicAuth

func (*BasicAuth) Middleware ¶

func (ba *BasicAuth) Middleware(next http.Handler) http.Handler

type ErrorInfo ¶

type ErrorInfo struct {
	Code    string       `json:"code"`
	Message string       `json:"message"`
	Details *interface{} `json:"details,omitempty"`
}

type Logger ¶

type Logger struct {
	*log.Logger
	// contains filtered or unexported fields
}

Bulbistry's extension of log.Logger to include the UUID in the logs.

func NewLogger ¶

func NewLogger(w io.Writer, logUUID *uuid.UUID) *Logger

type ResponseText ¶

type ResponseText struct {
	Errors []ErrorInfo `json:"errors"`
}

type UnauthorizedDetails ¶

type UnauthorizedDetails struct {
	Attempted string `json:"username_attempted"`
	Allowed   string `json:"username_allowed"`
}

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
cmd
bulbistry Module
internal
cmd Module

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL