Skip to content

Latest commit

 

History

History
506 lines (366 loc) · 9.77 KB

about.hbs.md

File metadata and controls

506 lines (366 loc) · 9.77 KB

Catalog of Tanzu Supply Chain Components

{{> 'partials/supply-chain/beta-banner' }}

This section introduces the catalog of components shipped with TAP. You will find all of these components in the "authoring" profile.

app-config-server

Version: 1.0.0

Description:

Generates configuration for a Server application from a Conventions PodIntent. Server applications contain a K8s Deployment and Service and can be configured with Ingress.

Inputs

Name Type
conventions conventions

Outputs

Name Type
oci-yaml-files oci-yaml-files
oci-ytt-files oci-ytt-files

Config

spec:
  # Configuration for the registry to use
  registry:
    # The name of the registry server, e.g. docker.io
    # +required
    server:
    # The name of the repository
    # +required
    repository:

app-config-web

Version: 1.0.0

Description:

Generates configuration for a Web application from a Conventions PodIntent. Web applications contain a Knative Service.

Inputs

Name Type
conventions conventions

Outputs

Name Type
oci-yaml-files oci-yaml-files
oci-ytt-files oci-ytt-files

Config

spec:
  # Configuration for the registry to use
  registry:
    # The name of the repository
    # +required
    repository:
    # The name of the registry server, e.g. docker.io
    # +required
    server:

app-config-worker

Version: 1.0.0

Description:

Generates configuration for a Worker application from a Conventions PodIntent. Worker applications contain a K8s Deployment.

Inputs

Name Type
conventions conventions

Outputs

Name Type
oci-yaml-files oci-yaml-files
oci-ytt-files oci-ytt-files

Config

spec:
  # Configuration for the registry to use
  registry:
    # The name of the repository
    # +required
    repository:
    # The name of the registry server, e.g. docker.io
    # +required
    server:

buildpack-build

Version: 1.0.0

Description:

Builds an app with buildpacks using kpack

Inputs

Name Type
source source
git git

Outputs

Name Type
image image

Config

spec:
  # Registry to use
  registry:
    # The registry address
    # +required
    server:
    # The repository to use
    # +required
    repository:
  # Kpack build specification
  build:
    # Service account to use
    serviceAccountName:
    env:
    # Configure workload to use a non-default builder or clusterbuilder
    builder:
      # builder kind
      kind:
      # builder name
      name:
    # cache options
    cache:
      # whether to use a cache image
      enabled:
      # cache image to use
      image:
  source:
    # path inside the source to build from (build has no access to paths above the subPath)
    subPath:

carvel-package

Version: 1.0.0

Description:

Generates a carvel package from OCI images containing raw YAML files and YTT files.

Inputs

Name Type
oci-yaml-files oci-yaml-files
oci-ytt-files oci-ytt-files

Outputs

Name Type
package package

Config

spec:
  # Configuration for the generated Carvel Package
  carvel:
    # The name of the Carvel Package. Combines with spec.carvel.packageDomain to create the Package refName. If set to "", will use the workload name.
    packageName:
    # Service account that gives kapp-controller privileges to create resources in the namespace.
    serviceAccountName:
    # Name of the values Secret that provides customized values to the package installation's templating steps.
    valuesSecretName:
    # PEM encoded certificate data for the image registry where the files will be pushed to.
    caCertData:
    # Enable the use of IAAS based authentication for imgpkg.
    iaasAuthEnabled:
    # The domain of the Carvel Package. Combines with spec.carvel.packageName to create the Package refName. If set to "", will use "default.tap".
    packageDomain:
  gitOps:
    # the branch to commit changes to
    branch:
    # the relative path within the gitops repository to add the package configuration to.
    subPath:
    # the repository to push the pull request to
    url:
  # Configuration for the registry to use
  registry:
    # The name of the repository
    # +required
    repository:
    # The name of the registry server, e.g. docker.io
    # +required
    server:

conventions

Version: 1.0.0

Description:

The Conventions component analyzes the image input as described in the Cartographer Conventions documentation and produces a conventions output image.

Depends on:

  • Managed Resource Controller.
    • Tanzu Carvel Package: managed-resource-controller.apps.tanzu.vmware.com @ >=0.1.2
  • Conventions Controller
    • Tanzu Carvel Package: cartographer.tanzu.vmware.com @ >= 0.8.10

Inputs

Name Type
image image

Outputs

Name Type
conventions conventions

Config

spec:
  # May contain an optional array of objects. Each object is a pair of keys: `name` and either `value` or `valueFrom`.
  # The Conventions component will translate these values into environment variables in the output object.
  env:

deployer

Version: 1.0.0

Description:

Deploys K8s resources to the cluster.

Inputs

Name Type
package package

Outputs

  • none

Config

spec:
  # The path to the yaml to be applied to the cluster.
  subPath:
    # The path to the yaml to be applied to the cluster
    # +required
    path:

git-writer

Version: 1.0.0

Description:

Writes carvel package config directly to a gitops repository

Inputs

Name Type
package package

Outputs

  • none

Config

spec:
  gitOps:
    # the repository to push the pull request to
    # +required
    url:
    # the branch to commit changes to
    branch:
    # the relative path within the gitops repository to add the package configuration to.
    subPath:

git-writer-pr

Version: 1.0.0

Description:

Writes carvel package config to a gitops repository and opens a PR

Inputs

Name Type
package package

Outputs

Name Type
git-pr git-pr

Config

spec:
  gitOps:
    # the base branch to create PRs against
    baseBranch:
    # the relative path within the gitops repository to add the package configuration to.
    subPath:
    # the repository to push the pull request to
    # +required
    url:

source-git-provider

Version: 1.0.0

Description:

Source git provider retrieves source code and monitors a git repository.

Inputs

  • none

Outputs

Name Type
source source
git git

Config

spec:
  source:
    # Use this object to retrieve source from a git repository.
    # The tag, commit and branch fields are mutually exclusive, use only one.
    # +required
    git:
      # A git branch ref to watch for new source
      branch:
      # A git commit sha to use
      commit:
      # A git tag ref to watch for new source
      tag:
      # The url to the git source repository
      # +required
      url:
    # The sub path in the bundle to locate source code
    subPath:

source-package-translator

Version: 1.0.0

Description:

Takes the type source and immediately outputs it as type package.

Inputs

Name Type
source source

Outputs

Name Type
package package

Config

none


trivy-image-scan

Version: 1.0.0

Description:

Performs a trivy image scan using the scan 2.0 components

Inputs

Name Type
image image
git git

Outputs

  • none

Config

spec:
  # Configuration for the registry to use
  registry:
    # The name of the repository
    # +required
    repository:
    # The name of the registry server, e.g. docker.io
    # +required
    server:
  source:
    # Fill this object in if you want your source to come from git.
    # The tag, commit and branch fields are mutually exclusive, use only one.
    # +required
    git:
      # A git branch ref to watch for new source
      branch:
      # A git commit sha to use
      commit:
      # A git tag ref to watch for new source
      tag:
      # The url to the git source repository
      # +required
      url:
    # The sub path in the bundle to locate source code
    subPath:
  # Image Scanning configuration
  scanning:
    service-account-scanner:
    workspace:
      size:
      bindings:
    active-keychains:
    service-account-publisher: