apttransports3go

README

apt-transport-s3-go

apt-transport-s3-go is a Go port of apt-transport-s3.

Installation

# download from https://github.com/winebarrel/apt-transport-s3-go/releases
dpkg -i apt-transport-s3-go_x.x.x_amd64.deb

Usage

# aws s3 ls s3://my-bucket/repo/
#                           PRE dists/
#                           PRE pool/

echo 'Acquire::s3::region ap-northeast-1;' > /etc/apt/apt.conf.d/s3
echo 'deb s3://my-bucket/repo/ xenial main' > /etc/apt/sources.list.d/s3.list
apt update
apt install any-pkg

Debug

export ATS3_LOG_LEVEL=debug
apt update

S3 download mode

/usr/lib/apt/methods/s3 s3://my-bucket/key

Related Links

• apt-transport-s3 License & Copyright
• APT Method Interface
• google/apt-golang-s3: An s3 transport method for the apt package management system

Documentation

Index

• Variables
• func Configure(ctx context.Context, header map[string][]string) (aws.Config, error)
• func Download(ctx context.Context, w io.Writer, api S3API, uriStr string) error
• func Fetch(ctx context.Context, w io.Writer, api S3API, header map[string][]string) error
• func Run(ctx context.Context, r io.Reader, w io.Writer) error
• func SendCapabilities(ctx context.Context, w io.Writer)
• type S3API
• type Status

Variables

var (
	// http://www.fifi.org/doc/libapt-pkg-doc/method.html/ch2.html
	StatusCapabilities             = newStatus(100, "Capabilities")
	StatusLog                      = newStatus(101, "Log")
	StatusStatus                   = newStatus(102, "Status")
	StatusURIStart                 = newStatus(200, "URI Start")
	StatusURIDone                  = newStatus(201, "URI Done")
	StatusURIFailure               = newStatus(400, "URI Failure")
	StatusGeneralFailure           = newStatus(401, "General Failure")
	StatusAuthorizationRequired    = newStatus(402, "Authorization Required")
	StatusMediaFailure             = newStatus(403, "Media Failure")
	StatusURIAcquire               = newStatus(600, "URI Acquire")
	StatusConfiguration            = newStatus(601, "Configuration")
	StatusAuthorizationCredentials = newStatus(602, "Authorization Credentials")
	StatusMediaChanged             = newStatus(603, "Media Changed")
)

Functions

func Configure

func Configure(ctx context.Context, header map[string][]string) (aws.Config, error)

func Download

func Download(ctx context.Context, w io.Writer, api S3API, uriStr string) error

func Fetch

func Fetch(ctx context.Context, w io.Writer, api S3API, header map[string][]string) error

func Run

func Run(ctx context.Context, r io.Reader, w io.Writer) error

func SendCapabilities

func SendCapabilities(ctx context.Context, w io.Writer)

Types

type S3API

type S3API interface {
	GetObject(ctx context.Context, params *s3.GetObjectInput, optFns ...func(*s3.Options)) (*s3.GetObjectOutput, error)
	HeadObject(ctx context.Context, params *s3.HeadObjectInput, optFns ...func(*s3.Options)) (*s3.HeadObjectOutput, error)
}

type Status

type Status int