Providing Feedback

Provide feedback at the survey

Experimental

Content in this chapter is experimental and will evolve based on user feedback.

Leave feedback on the conventions by creating an issue in the kubectl GitHub repository.

Also provide feedback on new kubectl docs at the survey

TL;DR
  • Publish a White Box Application as a Base for other users to Kustomize

Publishing Bases

Motivation

Users may want to run a common White Box Application without writing the Resource Config for the Application from scratch. Instead they may want to consume ready-made Resource Config published specifically for the White Box Application, and add customizations for their specific needs.

  • Run a White Box Application (e.g. Cassandra, MongoDB) instance from ready-made Resource Config
  • Publish Resource Config to run an Application

Publishing a White Box Base

White Box Applications may be published to a URL and consumed as Bases in an kustomization.yaml. It can then be consumed in the following manner.

Use Case: Run a White Box Application published to GitHub.

Input: The kustomization.yaml file

# kustomization.yaml
bases:
# GitHub URL
- github.com/kubernetes-sigs/kustomize/examples/multibases/dev/?ref=v1.0.6

Applied: The Resource that is Applied to the cluster

# Resource comes from the Remote Base
apiVersion: v1
kind: Pod
metadata:
  labels:
    app: myapp
  name: dev-myapp-pod
spec:
  containers:
  - image: nginx:1.7.9
    name: nginx

Customizing White Box Bases

The White Box Application may be customized using the same techniques described in Bases and Variations.

Versioning White Box Bases

White Box Bases may be versioned using the well known versioning techniques provided by Git.

Tag:

Bases may be versioned by applying a tag to the repo and modifying the url to point to the tag: github.com/kubernetes-sigs/kustomize/examples/multibases?ref=v1.0.6

Branch:

Bases may be versioned by creating a branch and modifying the url to point to the branch: github.com/Liujingfang1/kustomize/examples/helloWorld?ref=repoUrl2

Commit:

If the White Box Base has not been explicitly versioned by the maintainer, users may pin the base to a specific commit: github.com/Liujingfang1/kustomize/examples/helloWorld?ref=7050a45134e9848fca214ad7e7007e96e5042c03

Forking a White Box Base

Uses may fork a White Box Base hosted on GitHub by forking the GitHub repo. This allows the user complete control over changes to the Base. Users should periodically pull changes from the upstream repo back into the fork to get bug fixes and optimizations.

results matching ""

    No results matching ""