dotnetcoreaspnet

README

ASPNet Cloud Native Buildpack

The Dotnet Core ASPNet CNB provides a version of the Dotnet Core ASPNet Framework and sets an extension of the $DOTNET_ROOT location.

A usage example can be found in the samples repository under the dotnet-core/aspnet directory.

Integration

The Dotnet Core ASPNet CNB provides dotnet-aspnetcore as a dependency. Downstream buildpacks, like Dotnet Core Build and Dotnet Core SDK can require the dotnet-aspnetcore dependency by generating a Build Plan TOML file that looks like the following:

[[requires]]

  # The name of the ASPNet dependency is "dotnet-aspnetcore". This value is considered
  # part of the public API for the buildpack and will not change without a plan
  # for deprecation.
  name = "dotnet-aspnetcore"

  # The ASPNet buildpack supports some non-required metadata options.
  [requires.metadata]

    # Setting the build flag to true will ensure that the ASPNet
    # dependency is available to subsequent buildpacks during their build phase.
    # Currently we do not recommend having your application directly interface with
    # the framework, instead use the dotnet-core-sdk. However,
    # if you are writing a buildpack that needs to use the ASPNet during
    # its build process, this flag should be set to true.
    build = true

    # Setting the launch flag to true will ensure that the ASPNet
    # dependency is available on the $DOTNET_ROOT for the running application. If you are
    # writing an application that needs to run ASPNet at runtime, this flag should
    # be set to true.
    launch = true

    # The version of the ASPNet dependency is not required. In the case it
    # is not specified, the buildpack will provide the default version, which can
    # be seen in the buildpack.toml file.
    # If you wish to request a specific version, the buildpack supports
    # specifying a semver constraint in the form of "2.*", "2.1.*", or even
    # "2.1.15".
    version = "2.1.15"

To package this buildpack for consumption:

$ ./scripts/package.sh

Documentation

Index

• func Build(entries EntryResolver, dependencies DependencyManager, ...) packit.BuildFunc
• func Detect(buildpackYMLParser VersionParser) packit.DetectFunc
• type BuildPlanRefinery
• type BuildpackYMLParser
  • func NewBuildpackYMLParser() BuildpackYMLParser
  • func (p BuildpackYMLParser) ParseVersion(path string) (string, error)
• type DependencyManager
• type DotnetRootLinker
  • func NewDotnetRootLinker() DotnetRootLinker
  • func (dl DotnetRootLinker) Link(workingDir, layerPath string) error
• type EntryResolver
• type LogEmitter
  • func NewLogEmitter(output io.Writer) LogEmitter
  • func (e LogEmitter) Candidates(entries []packit.BuildpackPlanEntry)
  • func (l LogEmitter) Environment(env packit.Environment)
  • func (e LogEmitter) SelectedDependency(entry packit.BuildpackPlanEntry, dependency postal.Dependency, now time.Time)
• type PlanEntryResolver
  • func NewPlanEntryResolver(logger LogEmitter) PlanEntryResolver
  • func (r PlanEntryResolver) Resolve(entries []packit.BuildpackPlanEntry) packit.BuildpackPlanEntry
• type PlanRefinery
  • func NewPlanRefinery() PlanRefinery
  • func (pf PlanRefinery) BillOfMaterial(dependency postal.Dependency) packit.BuildpackPlan
• type Symlinker
• type VersionParser

Functions

func Build

func Build(entries EntryResolver, dependencies DependencyManager, planRefinery BuildPlanRefinery, symlinker Symlinker, logger LogEmitter, clock chronos.Clock) packit.BuildFunc

func Detect

func Detect(buildpackYMLParser VersionParser) packit.DetectFunc

Types

type BuildPlanRefinery

type BuildPlanRefinery interface {
	BillOfMaterial(dependency postal.Dependency) packit.BuildpackPlan
}

type BuildpackYMLParser

type BuildpackYMLParser struct{}

func NewBuildpackYMLParser

func NewBuildpackYMLParser() BuildpackYMLParser

func (BuildpackYMLParser) ParseVersion

func (p BuildpackYMLParser) ParseVersion(path string) (string, error)

type DependencyManager

type DependencyManager interface {
	Resolve(path, id, version, stack string) (postal.Dependency, error)
	Install(dependency postal.Dependency, cnbPath, layerPath string) error
}

type DotnetRootLinker

type DotnetRootLinker struct{}

func NewDotnetRootLinker

func NewDotnetRootLinker() DotnetRootLinker

func (DotnetRootLinker) Link

func (dl DotnetRootLinker) Link(workingDir, layerPath string) error

type EntryResolver

type EntryResolver interface {
	Resolve([]packit.BuildpackPlanEntry) packit.BuildpackPlanEntry
}

type LogEmitter

type LogEmitter struct {
	// Emitter is embedded and therefore delegates all of its functions to the
	// LogEmitter.
	scribe.Emitter
}

func NewLogEmitter

func NewLogEmitter(output io.Writer) LogEmitter

func (LogEmitter) Candidates

func (e LogEmitter) Candidates(entries []packit.BuildpackPlanEntry)

func (LogEmitter) Environment

func (l LogEmitter) Environment(env packit.Environment)

func (LogEmitter) SelectedDependency

func (e LogEmitter) SelectedDependency(entry packit.BuildpackPlanEntry, dependency postal.Dependency, now time.Time)

type PlanEntryResolver

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

func NewPlanEntryResolver

func NewPlanEntryResolver(logger LogEmitter) PlanEntryResolver

func (PlanEntryResolver) Resolve

func (r PlanEntryResolver) Resolve(entries []packit.BuildpackPlanEntry) packit.BuildpackPlanEntry

type PlanRefinery

type PlanRefinery struct{}

func NewPlanRefinery

func NewPlanRefinery() PlanRefinery

func (PlanRefinery) BillOfMaterial

func (pf PlanRefinery) BillOfMaterial(dependency postal.Dependency) packit.BuildpackPlan

type Symlinker

type Symlinker interface {
	Link(workingDir, layerPath string) (Err error)
}

type VersionParser

type VersionParser interface {
	ParseVersion(path string) (version string, err error)
}