Documentation ¶
Index ¶
- Constants
- func AnyMatch(toMatch []reference.Named, selectors []RefSelector) bool
- func FamiliarString(ref reference.Reference) string
- func MustParseNamed(s string) reference.Named
- func MustParseNamedTagged(s string) reference.NamedTagged
- func MustWithTag(name reference.Named, tag string) reference.NamedTagged
- func NewIDSet(ids ...ID) map[ID]bool
- func ParseNamed(s string) (reference.Named, error)
- func ParseNamedMulti(strs []string) ([]reference.Named, error)
- func ParseNamedTagged(s string) (reference.NamedTagged, error)
- type ID
- type MatchType
- type Name
- type RefSelector
- func (s RefSelector) AsNamedOnly() reference.Named
- func (s RefSelector) Empty() bool
- func (s RefSelector) MatchExact() bool
- func (s RefSelector) Matches(toMatch reference.Named) bool
- func (s RefSelector) MatchesAny(toMatch []reference.Named) bool
- func (s RefSelector) RefFamiliarName() string
- func (s RefSelector) RefFamiliarString() string
- func (s RefSelector) RefName() string
- func (s RefSelector) RefsEqual(other RefSelector) bool
- func (s RefSelector) String() string
- func (s RefSelector) WithExactMatch() RefSelector
- func (s RefSelector) WithNameMatch() RefSelector
- type RefSet
- func (rs RefSet) AddTagSuffix(suffix string) (TaggedRefs, error)
- func (rs RefSet) ClusterRef() reference.Named
- func (rs RefSet) LocalRef() reference.Named
- func (rs RefSet) MustWithRegistry(reg Registry) RefSet
- func (rs RefSet) Registry() Registry
- func (rs RefSet) Validate() error
- func (rs RefSet) WithoutRegistry() RefSet
- type Registry
- type Runtime
- type TaggedRefs
Constants ¶
const IstioInitContainerName = Name("istio-init")
const IstioSidecarContainerName = Name("istio-proxy")
Variables ¶
This section is empty.
Functions ¶
func AnyMatch ¶ added in v0.10.14
func AnyMatch(toMatch []reference.Named, selectors []RefSelector) bool
func FamiliarString ¶ added in v0.10.19
func MustParseNamed ¶
func MustParseNamedTagged ¶
func MustParseNamedTagged(s string) reference.NamedTagged
func MustWithTag ¶ added in v0.14.0
func MustWithTag(name reference.Named, tag string) reference.NamedTagged
func ParseNamedMulti ¶ added in v0.10.14
func ParseNamedTagged ¶
func ParseNamedTagged(s string) (reference.NamedTagged, error)
Types ¶
type RefSelector ¶ added in v0.7.11
type RefSelector struct {
// contains filtered or unexported fields
}
func MustParseSelector ¶ added in v0.7.11
func MustParseSelector(s string) RefSelector
func MustParseTaggedSelector ¶ added in v0.7.11
func MustParseTaggedSelector(s string) RefSelector
func NameSelector ¶ added in v0.7.11
func NameSelector(ref reference.Named) RefSelector
func NewRefSelector ¶ added in v0.7.11
func NewRefSelector(ref reference.Named) RefSelector
func SelectorFromImageMap ¶ added in v0.20.8
func SelectorFromImageMap(spec v1alpha1.ImageMapSpec) (RefSelector, error)
func (RefSelector) AsNamedOnly ¶ added in v0.7.11
func (s RefSelector) AsNamedOnly() reference.Named
AsNamedOnly returns the Ref as a Named, REMOVING THE TAG if one exists
func (RefSelector) Empty ¶ added in v0.7.11
func (s RefSelector) Empty() bool
func (RefSelector) MatchExact ¶ added in v0.20.8
func (s RefSelector) MatchExact() bool
func (RefSelector) Matches ¶ added in v0.7.11
func (s RefSelector) Matches(toMatch reference.Named) bool
func (RefSelector) MatchesAny ¶ added in v0.14.0
func (s RefSelector) MatchesAny(toMatch []reference.Named) bool
func (RefSelector) RefFamiliarName ¶ added in v0.7.11
func (s RefSelector) RefFamiliarName() string
func (RefSelector) RefFamiliarString ¶ added in v0.7.11
func (s RefSelector) RefFamiliarString() string
func (RefSelector) RefName ¶ added in v0.7.11
func (s RefSelector) RefName() string
func (RefSelector) RefsEqual ¶ added in v0.7.11
func (s RefSelector) RefsEqual(other RefSelector) bool
func (RefSelector) String ¶ added in v0.7.11
func (s RefSelector) String() string
func (RefSelector) WithExactMatch ¶ added in v0.7.11
func (s RefSelector) WithExactMatch() RefSelector
func (RefSelector) WithNameMatch ¶ added in v0.7.11
func (s RefSelector) WithNameMatch() RefSelector
type RefSet ¶ added in v0.14.0
type RefSet struct { // Ref as specified in Tiltfile; used to match a DockerBuild with // corresponding k8s YAML. May contain tags, etc. (Also used as // user-facing name for this image.) ConfigurationRef RefSelector // contains filtered or unexported fields }
RefSet describes the references for a given image:
- ConfigurationRef: ref as specified in the Tiltfile
- LocalRef(): ref as used outside of the cluster (for Docker etc.)
- ClusterRef(): ref as used inside the cluster (in k8s YAML etc.). Often equivalent to LocalRef, but in some cases they diverge: e.g. when using a local registry with KIND, the image localhost:1234/my-image (localRef) is referenced in the YAML as http://registry/my-image (clusterRef).
func MustSimpleRefSet ¶ added in v0.14.0
func MustSimpleRefSet(ref RefSelector) RefSet
func (RefSet) AddTagSuffix ¶ added in v0.17.2
func (rs RefSet) AddTagSuffix(suffix string) (TaggedRefs, error)
AddTagSuffix tags the references for build/deploy.
In most cases, we will use the tag given as-is.
If we're in the mode where we're pushing to a single image name (for ECR), we'll tag it with [escaped-original-name]-[suffix].
func (RefSet) ClusterRef ¶ added in v0.14.0
ClusterRef returns the ref by which this image is referenced in the cluster. In most cases the image's ref from the cluster is the same as its ref locally; currently, we only allow these refs to diverge if the user provides a default registry with different urls for Host and hostFromCluster. If registry.hostFromCluster is not set, we return localRef.
func (RefSet) LocalRef ¶ added in v0.14.0
LocalRef returns the ref by which this image is referenced from outside the cluster (e.g. by `docker build`, `docker push`, etc.)
func (RefSet) MustWithRegistry ¶ added in v0.14.0
func (RefSet) WithoutRegistry ¶ added in v0.14.0
type Registry ¶ added in v0.8.9
type Registry struct { // The Host of a container registry where we can push images. e.g.: // - localhost:32000 // - gcr.io/windmill-public-containers Host string // ECR Image registries work differently than other image registries. // // The registry takes the form // https://aws_account_id.dkr.ecr.region.amazonaws.com // // And each image name in that registry must be pre-created ಠ_ಠ and assigned IAM permissions. // https://aws_account_id.dkr.ecr.region.amazonaws.com/my-repo // (They call this a repo). // // For this reason, some users using ECR prefer to push all images to a single image name. // // I (Nick) am hoping people use this to create a "personal" dev image repo // for each user for dev. // // People have also suggested having a "image name transform function" that matches // the "normal" image name to an existing repo. // // See: // https://docs.aws.amazon.com/AmazonECR/latest/userguide/Repositories.html // https://github.com/tilt-dev/tilt/issues/2419 SingleName string // contains filtered or unexported fields }
func MustNewRegistry ¶ added in v0.14.0
func MustNewRegistryWithHostFromCluster ¶ added in v0.14.0
func NewRegistry ¶ added in v0.14.0
func NewRegistryWithHostFromCluster ¶ added in v0.14.0
func (Registry) HostFromCluster ¶ added in v0.14.0
HostFromCluster returns the registry to be used from within the k8s cluster (e.g. in k8s YAML). Returns hostFromCluster, if specified; otherwise the Host.
func (Registry) ReplaceRegistryForClusterRef ¶ added in v0.14.0
func (r Registry) ReplaceRegistryForClusterRef(rs RefSelector) (reference.Named, error)
func (Registry) ReplaceRegistryForLocalRef ¶ added in v0.14.0
func (r Registry) ReplaceRegistryForLocalRef(rs RefSelector) (reference.Named, error)
type Runtime ¶ added in v0.7.11
type Runtime string
A good way to manually test different container runtimes is with minikube. https://github.com/kubernetes/minikube/blob/master/docs/alternative_runtimes.md
func RuntimeFromVersionString ¶ added in v0.7.11
type TaggedRefs ¶ added in v0.14.0
type TaggedRefs struct { LocalRef reference.NamedTagged // Image name + tag as referenced from outside cluster ClusterRef reference.NamedTagged // Image name + tag as referenced from within cluster }
Refs yielded by an image build