Merge pull request #729 from wonderflow/setup

fix build issue

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,7 +1,7 @@
 ---
-name: Bug report
+name: "\U0001F41B Bug report"
 about: Create a report to help us improve
-title: "[BUG]"
+title: ""
 labels: kind/bug
 assignees: ''
 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,5 +1,5 @@
 ---
-name: Feature request
+name: "\U0001F680 Feature request"
 about: Suggest an idea for this project
 title: "[Feature]"
 labels: kind/feature

.github/workflows/dashboard.yml

@@ -4,12 +4,16 @@ on:
   push:
     branches: [ master ]
   pull_request:
+    branches: [master]
+    paths-ignore:
+    - 'docs/**'
+    - '**.md'
 defaults:
   run:
     working-directory: ./dashboard
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-20.04
     strategy:
       matrix:
         node-version: [10.x]

.github/workflows/docker.yml

@@ -3,23 +3,54 @@ on:
   push:
     branches:
       - master
+    tags:
+      - "v*"
+
 jobs:
   update:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@master
-      - name: Publish to Github Docker Package Registry
-        uses: elgohr/Publish-Docker-Github-Action@2.21
+      - name: Get the version
+        id: get_version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/}
+          if [[ ${GITHUB_REF} == "refs/heads/master" ]]; then
+            VERSION=latest
+          fi
+          echo ::set-output name=VERSION::${VERSION}
+      - name: Get git revision
+        id: vars
+        shell: bash
+        run: |
+          echo "::set-output name=git_revision::$(git rev-parse --short HEAD)"
+      - name: Login ghcr.io
+        uses: docker/login-action@v1
         with:
-          name: oam-dev/kubevela/vela-core
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-          registry: docker.pkg.github.com
-          tags: "latest"
-      - name: Publish to Docker Hub Registry
-        uses: elgohr/Publish-Docker-Github-Action@2.21
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.CR_PAT }}
+      - name: Login docker.io
+        uses: docker/login-action@v1
         with:
-          name: oamdev/vela-core
+          registry: docker.io
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
-          tags: "latest"
+      - uses: docker/setup-qemu-action@v1
+      - uses: docker/setup-buildx-action@v1
+      - uses: docker/build-push-action@v2
+        name: Build & Pushing
+        with:
+          context: .
+          file: Dockerfile
+          labels: |-
+            org.opencontainers.image.source=https://github.com/${{ github.repository }}
+            org.opencontainers.image.revision=${{ github.sha }}
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          build-args: |
+            GITVERSION=git-${{ steps.vars.outputs.git_revision }}
+            VERSION=${{ steps.get_version.outputs.VERSION }}
+          tags: |-
+            ghcr.io/${{ github.repository }}/vela-core:${{ steps.get_version.outputs.VERSION }}
+            docker.io/oamdev/vela-core:${{ steps.get_version.outputs.VERSION }}

.github/workflows/e2e.yml

@@ -1,48 +0,0 @@
-name: E2E
-
-on:
-  push:
-    branches: [master]
-  pull_request:
-    branches: [master]
-
-jobs:
-  build:
-    name: e2e-tests
-    runs-on: aliyun
-    steps:
-      - name: Check out code into the Go module directory
-        uses: actions/checkout@v2
-
-      - name: Get dependencies
-        run: |
-          go get -v -t -d ./...
-
-      - name: Setup Kind Cluster
-        uses: engineerd/setup-kind@v0.4.0
-        with:
-          version: "v0.7.0"
-          skipClusterCreation: true
-
-      - name: Setup Kind Cluster
-        run: |
-          kind delete cluster
-          kind create cluster
-          kubectl version
-          kubectl cluster-info
-
-      - name: Load Image to kind cluster
-        run: make kind-load
-
-      - name: Run Make
-        run: make
-
-      - name: Run Make Manager
-        run: make manager
-
-      - name: Run e2e tests
-        run: |
-          make e2e-cleanup
-          make e2e-setup
-          make e2e-test
-          make e2e-api-test

.github/workflows/go.yml

@@ -2,35 +2,57 @@ name: Go
 
 on:
   push:
-    branches: [master]
+    branches:
+      - master
+      - release-*
+  workflow_dispatch: {}
   pull_request:
     branches: [master]
+    paths-ignore:
+    - 'docs/**'
+    - '**.md'
+
+env:
+  # Common versions
+  GO_VERSION: '1.14'
+  GOLANGCI_VERSION: 'v1.31'
+  DOCKER_BUILDX_VERSION: 'v0.4.2'
+  KIND_VERSION: 'v0.7.0'
 
 jobs:
-  build:
-    name: unit-tests
+
+  unit-tests:
     runs-on: ubuntu-20.04
     steps:
       - name: Set up Go 1.14
         uses: actions/setup-go@v1
         with:
-          go-version: 1.14
+          go-version: ${{ env.GO_VERSION }}
         id: go
 
       - name: Check out code into the Go module directory
         uses: actions/checkout@v2
+        with:
+          submodules: true
+
+      - name: Cache Go Dependencies
+        uses: actions/cache@v2
+        with:
+          path: .work/pkg
+          key: ${{ runner.os }}-pkg-${{ hashFiles('**/go.sum') }}
+          restore-keys: ${{ runner.os }}-pkg-
 
       - name: Install ginkgo
         run:  |
           sudo apt-get install -y golang-ginkgo-dev
 
       - name: Setup Kind Cluster
-        uses: engineerd/setup-kind@v0.4.0
+        uses: engineerd/setup-kind@v0.5.0
         with:
-          version: "v0.7.0"
+          version: ${{ env.KIND_VERSION }}
 
       - name: install Kubebuilder
-        uses: RyanSiu1995/kubebuilder-action@v1
+        uses: wonderflow/kubebuilder-action@v1.1
 
       - name: Run Make test
         run: make test
@@ -42,3 +64,91 @@ jobs:
           file: ./coverage.txt
           flags: unittests
           name: codecov-umbrella
+
+  e2e-tests:
+    runs-on: aliyun
+    steps:
+      - name: Check out code into the Go module directory
+        uses: actions/checkout@v2
+
+      - name: Get dependencies
+        run: |
+          go get -v -t -d ./...
+
+      - name: Setup Kind Cluster
+        uses: engineerd/setup-kind@v0.5.0
+        with:
+          version: ${{ env.KIND_VERSION }}
+          skipClusterCreation: true
+
+      - name: Setup Kind Cluster
+        run: |
+          kind delete cluster
+          kind create cluster
+          kubectl version
+          kubectl cluster-info
+
+      - name: Load Image to kind cluster
+        run: make kind-load
+
+      - name: Run Make
+        run: make
+
+      - name: Run Make Manager
+        run: make manager
+
+      - name: Run e2e tests
+        run: |
+          make e2e-cleanup
+          make e2e-setup
+          make e2e-api-test
+          make e2e-test
+
+  lint:
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          submodules: true
+
+      - name: Cache Go Dependencies
+        uses: actions/cache@v2
+        with:
+          path: .work/pkg
+          key: ${{ runner.os }}-pkg-${{ hashFiles('**/go.sum') }}
+          restore-keys: ${{ runner.os }}-pkg-
+
+      # This action uses its own setup-go, which always seems to use the latest
+      # stable version of Go. We could run 'make lint' to ensure our desired Go
+      # version, but we prefer this action because it leaves 'annotations' (i.e.
+      # it comments on PRs to point out linter violations).
+      - name: Lint
+        uses: golangci/golangci-lint-action@v2
+        with:
+          version: ${{ env.GOLANGCI_VERSION }}
+
+  check-diff:
+    runs-on: ubuntu-20.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          submodules: true
+
+      - name: Setup Go
+        uses: actions/setup-go@v2
+        with:
+          go-version: ${{ env.GO_VERSION }}
+
+      - name: Cache Go Dependencies
+        uses: actions/cache@v2
+        with:
+          path: .work/pkg
+          key: ${{ runner.os }}-pkg-${{ hashFiles('**/go.sum') }}
+          restore-keys: ${{ runner.os }}-pkg-
+
+      - name: Check Diff
+        run: make check-diff

.github/workflows/release.yml

@@ -20,6 +20,9 @@ jobs:
         id: go
       - name: Check out code into the Go module directory
         uses: actions/checkout@v2
+      - name: Get the version
+        id: get_version
+        run: echo ::set-output name=VERSION::${GITHUB_REF#refs/tags/}
       - name: Use Node.js 10.x
         uses: actions/setup-node@v1
         with:
@@ -28,6 +31,10 @@ jobs:
         run: make npm-install
       - name: Run npm build
         run: make npm-build
+      - name: Tag helm chart image
+        run:  |
+          sed -i 's/latest/${{ steps.get_version.outputs.VERSION }}/g' charts/vela-core/values.yaml
+          sed -i 's/0.1.0/${{ steps.get_version.outputs.VERSION }}/g' charts/vela-core/Chart.yaml
       - name: Run generate-source
         run: make generate-source
       - name: Run cross-build
@@ -40,9 +47,6 @@ jobs:
         with:
           tag_name: ${{ github.ref }}
           release_name: Release ${{ github.ref }}
-      - name: Get the version
-        id: get_version
-        run: echo ::set-output name=VERSION::${GITHUB_REF#refs/tags/}
       - name: Upload Linux tar.gz
         uses: actions/upload-release-asset@v1.0.2
         with:
@@ -91,19 +95,4 @@ jobs:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
           asset_path: ./_bin/sha256sums.txt
           asset_name: sha256sums.txt
-          asset_content_type: text/plain
-      - name: Publish to Github Docker Package Registry
-        uses: elgohr/Publish-Docker-Github-Action@2.21
-        with:
-          name: oam-dev/kubevela/vela-core
-          username: $GITHUB_ACTOR
-          password: ${{ secrets.GITHUB_TOKEN }}
-          registry: docker.pkg.github.com
-          tags: "${{ steps.get_version.outputs.VERSION }}"
-      - name: Publish to Docker Hub Registry
-        uses: elgohr/Publish-Docker-Github-Action@2.21
-        with:
-          name: oamdev/vela-core
-          username: ${{ secrets.DOCKER_USERNAME }}
-          password: ${{ secrets.DOCKER_PASSWORD }}
-          tags: "${{ steps.get_version.outputs.VERSION }}"
+          asset_content_type: text/plain

.golangci.yml

@@ -0,0 +1,206 @@
+run:
+  timeout: 10m
+
+  skip-files:
+    - "zz_generated\\..+\\.go$"
+    - ".*_test.go$"
+
+  skip-dirs:
+    - "hack"
+    - "e2e"
+
+output:
+  # colored-line-number|line-number|json|tab|checkstyle|code-climate, default is "colored-line-number"
+  format: colored-line-number
+
+linters-settings:
+  errcheck:
+    # report about not checking of errors in type assetions: `a := b.(MyStruct)`;
+    # default is false: such cases aren't reported by default.
+    check-type-assertions: false
+
+    # report about assignment of errors to blank identifier: `num, _ := strconv.Atoi(numStr)`;
+    # default is false: such cases aren't reported by default.
+    check-blank: false
+
+    # [deprecated] comma-separated list of pairs of the form pkg:regex
+    # the regex is used to ignore names within pkg. (default "fmt:.*").
+    # see https://github.com/kisielk/errcheck#the-deprecated-method for details
+    ignore: fmt:.*,io/ioutil:^Read.*
+
+  exhaustive:
+    # indicates that switch statements are to be considered exhaustive if a
+    # 'default' case is present, even if all enum members aren't listed in the
+    # switch
+    default-signifies-exhaustive: true
+
+  govet:
+    # report about shadowed variables
+    check-shadowing: false
+
+  golint:
+    # minimal confidence for issues, default is 0.8
+    min-confidence: 0.8
+
+  gofmt:
+    # simplify code: gofmt with `-s` option, true by default
+    simplify: true
+
+  goimports:
+    # put imports beginning with prefix after 3rd-party packages;
+    # it's a comma-separated list of prefixes
+    local-prefixes: github.com/oam-dev/kubevela
+
+  gocyclo:
+    # minimal code complexity to report, 30 by default (but we recommend 10-20)
+    min-complexity: 30
+
+  maligned:
+    # print struct with more effective memory layout or not, false by default
+    suggest-new: true
+
+  dupl:
+    # tokens count to trigger issue, 150 by default
+    threshold: 100
+
+  goconst:
+    # minimal length of string constant, 3 by default
+    min-len: 3
+    # minimal occurrences count to trigger, 3 by default
+    min-occurrences: 5
+
+  lll:
+    # tab width in spaces. Default to 1.
+    tab-width: 1
+
+  unused:
+    # treat code as a program (not a library) and report unused exported identifiers; default is false.
+    # XXX: if you enable this setting, unused will report a lot of false-positives in text editors:
+    # if it's called for subdir of a project it can't find funcs usages. All text editor integrations
+    # with golangci-lint call it on a directory with the changed file.
+    check-exported: false
+
+  unparam:
+    # Inspect exported functions, default is false. Set to true if no external program/library imports your code.
+    # XXX: if you enable this setting, unparam will report a lot of false-positives in text editors:
+    # if it's called for subdir of a project it can't find external interfaces. All text editor integrations
+    # with golangci-lint call it on a directory with the changed file.
+    check-exported: false
+
+  nakedret:
+    # make an issue if func has more lines of code than this setting and it has naked returns; default is 30
+    max-func-lines: 30
+
+  gocritic:
+    # Enable multiple checks by tags, run `GL_DEBUG=gocritic golangci-lint` run to see all tags and checks.
+    # Empty list by default. See https://github.com/go-critic/go-critic#usage -> section "Tags".
+    enabled-tags:
+      - performance
+
+    settings: # settings passed to gocritic
+      captLocal: # must be valid enabled check name
+        paramsOnly: true
+      rangeValCopy:
+        sizeThreshold: 32
+
+linters:
+  enable:
+    - megacheck
+    - govet
+    - gocyclo
+    - gocritic
+    - interfacer
+    - goconst
+    - goimports
+    - gofmt  # We enable this as well as goimports for its simplify mode.
+    - golint
+    - unconvert
+    - misspell
+    - nakedret
+
+  presets:
+    - bugs
+    - unused
+  fast: false
+
+
+issues:
+  # Excluding configuration per-path and per-linter
+  exclude-rules:
+    # Exclude some linters from running on tests files.
+    - path: _test(ing)?\.go
+      linters:
+        - gocyclo
+        - errcheck
+        - dupl
+        - gosec
+        - scopelint
+        - unparam
+
+    # Ease some gocritic warnings on test files.
+    - path: _test\.go
+      text: "(unnamedResult|exitAfterDefer)"
+      linters:
+        - gocritic
+
+    # These are performance optimisations rather than style issues per se.
+    # They warn when function arguments or range values copy a lot of memory
+    # rather than using a pointer.
+    - text: "(hugeParam|rangeValCopy):"
+      linters:
+        - gocritic
+
+    # This "TestMain should call os.Exit to set exit code" warning is not clever
+    # enough to notice that we call a helper method that calls os.Exit.
+    - text: "SA3000:"
+      linters:
+        - staticcheck
+
+    - text: "k8s.io/api/core/v1"
+      linters:
+        - goimports
+
+    # This is a "potential hardcoded credentials" warning. It's triggered by
+    # any variable with 'secret' in the same, and thus hits a lot of false
+    # positives in Kubernetes land where a Secret is an object type.
+    - text: "G101:"
+      linters:
+        - gosec
+        - gas
+
+    # This is an 'errors unhandled' warning that duplicates errcheck.
+    - text: "G104:"
+      linters:
+        - gosec
+        - gas
+
+    # The Azure AddToUserAgent method appends to the existing user agent string.
+    # It returns an error if you pass it an empty string lettinga you know the
+    # user agent did not change, making it more of a warning.
+    - text: \.AddToUserAgent
+      linters:
+        - errcheck
+
+    - text: "don't use an underscore"
+      linters:
+        - golint
+
+  # Independently from option `exclude` we use default exclude patterns,
+  # it can be disabled by this option. To list all
+  # excluded by default patterns execute `golangci-lint run --help`.
+  # Default value for this option is true.
+  exclude-use-default: false
+
+  # Show only new issues: if there are unstaged changes or untracked files,
+  # only those changes are analyzed, else only changes in HEAD~ are analyzed.
+  # It's a super-useful option for integration of golangci-lint into existing
+  # large codebase. It's not practical to fix all existing issues at the moment
+  # of integration: much better don't allow issues in new code.
+  # Default is false.
+  new: false
+
+  # Maximum issues count per one linter. Set to 0 to disable. Default is 50.
+  max-per-linter: 0
+
+  # Maximum count of issues with the same text. Set to 0 to disable. Default is 3.
+  max-same-issues: 0

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# CONTRIBUTING
+# CONTRIBUTING Guide
 
 ## About KubeVela
 
@@ -7,14 +7,19 @@ KubeVela project is initialized and maintained by the cloud native community sin
 This doc explains how to set up a development environment, so you can get started
 contributing to `kubevela` or build a PoC (Proof of Concept). 
 
-## Prerequisites
+
+## Development
+
+### Prerequisites
 
 1. Golang version 1.13+
 2. Kubernetes version v1.16+ with `~/.kube/config` configured.
 3. ginkgo 1.14.0+ (just for [E2E test](https://github.com/oam-dev/kubevela/blob/master/DEVELOPMENT.md#e2e-test))
 4. golangci-lint 1.31.0+, it will install automatically if you run `make`, you can [install it manually](https://golangci-lint.run/usage/install/#local-installation) if the installation is too slow.
 
-## Build
+We also recommend you to learn about KubeVela's [design](docs/en/design.md) before dive into its code.
+
+### Build
 
 * Clone this project
 
@@ -61,7 +66,7 @@ make core-run
 This command will run controller locally, it will use your local KubeConfig which means you need to have a k8s cluster
 locally. If you don't have a one, we suggest that you could setup up a cluster with [kind](https://kind.sigs.k8s.io/).
 
-## Use
+### Use
 
 * Create environment
  
@@ -130,7 +135,7 @@ $ vela delete abc
   delete apps succeed abc from default
 ```
 
-## Tests
+## Testing
 
 ### Unit test
 
@@ -154,3 +159,11 @@ make e2e-test
 
 ## Make a pull request
 Remember to write unit-test and e2e test before making a pull request.
+
+## Merge Regulations
+
+Before merging, the pull request should obey the following rules:
+
+- The commit title and message should be clear about what this PR does.
+- All test CI should pass green.
+- The `codecov/project` should pass. This means the coverage should not drop. See [Codecov commit status](https://docs.codecov.io/docs/commit-status#project-status).

Dockerfile

@@ -1,5 +1,5 @@
 # Build the manager binary
-FROM golang:1.13 as builder
+FROM --platform=${BUILDPLATFORM:-linux/amd64} golang:1.14 as builder
 
 WORKDIR /workspace
 # Copy the Go Modules manifests
@@ -11,18 +11,28 @@ RUN go mod download
 
 # Copy the go source
 COPY cmd/core/main.go main.go
-COPY api/ api/
+COPY apis/ apis/
 COPY pkg/ pkg/
+COPY version/ version/
 
 # Build
-RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 GO111MODULE=on go build -a -o manager main.go
+ARG TARGETARCH
+ARG VERSION
+ARG GITVERSION
+RUN CGO_ENABLED=0 GOOS=linux GOARCH=${TARGETARCH} GO111MODULE=on \
+    go build -a -ldflags "-X github.com/oam-dev/kubevela/version.VelaVersion=${VERSION:-undefined} -X github.com/oam-dev/kubevela/version.GitRevision=${GITVERSION:-undefined}" \
+    -o manager-${TARGETARCH} main.go
 
 # Use distroless as minimal base image to package the manager binary
 # Refer to https://github.com/GoogleContainerTools/distroless for more details
-# oamdev/gcr.io-distroless-static:nonroot is syncd from gcr.io/distroless/static:nonroot as somewhere can't reach gcr.io
-FROM oamdev/gcr.io-distroless-static:nonroot
+# Could use `--build-arg=BASE_DISTROLESS=gcr.io/distroless/static:nonroot` to overwrite
+ARG BASE_DISTROLESS
+FROM ${BASE_DISTROLESS:-gcr.io/distroless/static:nonroot}
+
 WORKDIR /
-COPY --from=builder /workspace/manager .
+
+ARG TARGETARCH
+COPY --from=builder /workspace/manager-${TARGETARCH} /manager
 USER nonroot:nonroot
 
 ENTRYPOINT ["/manager"]

Makefile

@@ -1,14 +1,30 @@
 # Vela version
-VELA_VERSION ?= 0.1.0
+VELA_VERSION ?= master
 # Repo info
-GIT_COMMIT ?= git-$(shell git rev-parse --short HEAD)
-VELA_VERSION_VAR := github.com/oam-dev/kubevela/version.VelaVersion
+GIT_COMMIT          ?= git-$(shell git rev-parse --short HEAD)
+VELA_VERSION_VAR    := github.com/oam-dev/kubevela/version.VelaVersion
 VELA_GITVERSION_VAR := github.com/oam-dev/kubevela/version.GitRevision
-LDFLAGS ?= "-X $(VELA_VERSION_VAR)=$(VELA_VERSION) -X $(VELA_GITVERSION_VAR)=$(GIT_COMMIT)"
+LDFLAGS             ?= "-X $(VELA_VERSION_VAR)=$(VELA_VERSION) -X $(VELA_GITVERSION_VAR)=$(GIT_COMMIT)"
 
-GOX      = go run github.com/mitchellh/gox
-TARGETS  := darwin/amd64 linux/amd64 windows/amd64
-DIST_DIRS       := find * -type d -exec
+GOX         = go run github.com/mitchellh/gox
+TARGETS     := darwin/amd64 linux/amd64 windows/amd64
+DIST_DIRS   := find * -type d -exec
+
+TIME_LONG	= `date +%Y-%m-%d' '%H:%M:%S`
+TIME_SHORT	= `date +%H:%M:%S`
+TIME		= $(TIME_SHORT)
+
+BLUE         := $(shell printf "\033[34m")
+YELLOW       := $(shell printf "\033[33m")
+RED          := $(shell printf "\033[31m")
+GREEN        := $(shell printf "\033[32m")
+CNone        := $(shell printf "\033[0m")
+
+INFO	= echo ${TIME} ${BLUE}[ .. ]${CNone}
+WARN	= echo ${TIME} ${YELLOW}[WARN]${CNone}
+ERR		= echo ${TIME} ${RED}[FAIL]${CNone}
+OK		= echo ${TIME} ${GREEN}[ OK ]${CNone}
+FAIL	= (echo ${TIME} ${RED}[FAIL]${CNone} && false)
 
 # Get the currently used golang install path (in GOPATH/bin, unless GOBIN is set)
 ifeq (,$(shell go env GOBIN))
@@ -22,12 +38,14 @@ all: build
 # Run tests
 test: vet lint
 	go test -race -coverprofile=coverage.txt -covermode=atomic ./pkg/... ./cmd/...
+	@$(OK) unit-tests pass
 
 # Build manager binary
 build: fmt vet lint
 	go run hack/chart/generate.go
 	go build -o bin/vela -ldflags ${LDFLAGS} cmd/vela/main.go
 	git checkout cmd/vela/fake/chart_source.go
+	@$(OK) build succeed
 
 vela-cli:
 	go build -o bin/vela -ldflags ${LDFLAGS} cmd/vela/main.go
@@ -41,6 +59,7 @@ npm-install:
 doc-gen:
 	rm -r docs/en/cli/*
 	go run hack/docgen/gen.go
+	go run hack/references/generate.go
 
 generate-source:
 	go run hack/frontend/source.go
@@ -64,20 +83,29 @@ run: fmt vet
 	go run ./cmd/core/main.go
 
 # Run go fmt against code
-fmt:
+fmt: goimports installcue
 	go fmt ./...
-	./hack/cue-fmt.sh
+	$(GOIMPORTS) -local github.com/oam-dev/kubevela -w ./pkg ./cmd
+	$(CUE) fmt ./hack/vela-templates/cue/*
 
 # Run go vet against code
 vet:
 	go vet ./...
 
 lint: golangci
-	$(GOLANGCILINT) run --timeout 10m -E golint,goimports  ./...
+	$(GOLANGCILINT) run  ./...
+
+reviewable: fmt vet lint manifests
+	go mod tidy
+
+# Execute auto-gen code commands and ensure branch is clean.
+check-diff: reviewable
+	git diff --quiet || ($(ERR) please run 'make reviewable' to include all changes && false)
+	@$(OK) branch is clean
 
 # Build the docker image
-docker-build: test
-	docker build . -t ${IMG}
+docker-build:
+	docker build --build-arg=VERSION=$(VELA_VERSION) --build-arg=GITVERSION=$(GIT_COMMIT) . -t ${IMG}
 
 # Push the docker image
 docker-push:
@@ -93,6 +121,10 @@ e2e-setup:
 e2e-test:
 	# Run e2e test
 	ginkgo -v -skipPackage capability,setup,apiserver -r e2e
+	ginkgo -v ./test/e2e-test
+	# integration test will clean environment, please don't put test behind it.
+	CGO_ENABLED=0 go test -timeout 1h -count=1 -v -tags 'integration' ./test/integration
+	@$(OK) tests pass
 
 e2e-api-test:
 	# Run e2e test
@@ -109,27 +141,28 @@ kind-load:
 
 # Image URL to use all building/pushing image targets
 IMG ?= vela-core:latest
-# Produce CRDs that work back to Kubernetes 1.11 (no version conversion)
-CRD_OPTIONS ?= "crd:crdVersions=v1"
 
 # Run tests
-core-test: generate fmt vet manifests
+core-test: fmt vet manifests
 	go test ./pkg/... -coverprofile cover.out
 
 # Build manager binary
-manager: generate fmt vet lint manifests
+manager: fmt vet lint manifests
 	go build -o bin/manager ./cmd/core/main.go
 
 # Run against the configured Kubernetes cluster in ~/.kube/config
-core-run: generate fmt vet manifests
+core-run: fmt vet manifests
 	go run ./cmd/core/main.go
 
 # Install CRDs and Definitions of Vela Core into a cluster, this is for develop convenient.
 core-install: manifests
+	kubectl apply -f hack/namespace.yaml
 	kubectl apply -f charts/vela-core/crds/
 	kubectl apply -f charts/vela-core/templates/defwithtemplate/
 	kubectl apply -f charts/vela-core/templates/definitions/
-	bin/vela system update
+	kubectl apply -f charts/vela-core/templates/velaConfig.yaml
+	bin/vela workloads
+	@$(OK) install succeed
 
 # Uninstall CRDs and Definitions of Vela Core from a cluster, this is for develop convenient.
 core-uninstall: manifests
@@ -138,31 +171,10 @@ core-uninstall: manifests
 	kubectl delete -f charts/vela-core/crds/
 
 # Generate manifests e.g. CRD, RBAC etc.
-manifests: controller-gen
-	$(CONTROLLER_GEN) $(CRD_OPTIONS) rbac:roleName=manager-role webhook paths="./..." output:crd:artifacts:config=charts/vela-core/crds
+manifests:
+	go generate $(foreach t,pkg apis,./$(t)/...)
 	./hack/vela-templates/gen_definitions.sh
 
-# Generate code
-generate: controller-gen
-	$(CONTROLLER_GEN) object:headerFile="hack/boilerplate.go.txt" paths="./..."
-
-# find or download controller-gen
-# download controller-gen if necessary
-controller-gen:
-ifeq (, $(shell which controller-gen))
-	@{ \
-	set -e ;\
-	CONTROLLER_GEN_TMP_DIR=$$(mktemp -d) ;\
-	cd $$CONTROLLER_GEN_TMP_DIR ;\
-	go mod init tmp ;\
-	go get sigs.k8s.io/controller-tools/cmd/controller-gen@v0.2.5 ;\
-	rm -rf $$CONTROLLER_GEN_TMP_DIR ;\
-	}
-CONTROLLER_GEN=$(GOBIN)/controller-gen
-else
-CONTROLLER_GEN=$(shell which controller-gen)
-endif
-
 GOLANGCILINT_VERSION ?= v1.29.0
 HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]')
 HOSTARCH := $(shell uname -m)
@@ -182,3 +194,27 @@ GOLANGCILINT=$(GOBIN)/golangci-lint
 else
 GOLANGCILINT=$(shell which golangci-lint)
 endif
+
+.PHONY: goimports
+goimports:
+ifeq (, $(shell which goimports))
+	@{ \
+	set -e ;\
+	GO111MODULE=off go get -u golang.org/x/tools/cmd/goimports ;\
+	}
+GOIMPORTS=$(GOBIN)/goimports
+else
+GOIMPORTS=$(shell which goimports)
+endif
+
+.PHONY: installcue
+installcue:
+ifeq (, $(shell which cue))
+	@{ \
+	set -e ;\
+	GO111MODULE=off go get -u cuelang.org/go/cmd/cue ;\
+	}
+CUE=$(GOBIN)/cue
+else
+CUE=$(shell which cue)
+endif

README.md

@@ -1,4 +1,13 @@
-![alt](resources/KubeVela-03.png)
+![Build status](https://github.com/oam-dev/kubevela/workflows/E2E/badge.svg)
+[![Go Report Card](https://goreportcard.com/badge/github.com/oam-dev/kubevela)](https://goreportcard.com/report/github.com/oam-dev/kubevela)
+![Docker Pulls](https://img.shields.io/docker/pulls/oamdev/vela-core)
+[![codecov](https://codecov.io/gh/oam-dev/kubevela/branch/master/graph/badge.svg)](https://codecov.io/gh/oam-dev/kubevela)
+[![LICENSE](https://img.shields.io/github/license/oam-dev/kubevela.svg?style=flat-square)](/LICENSE)
+[![Releases](https://img.shields.io/github/release/oam-dev/kubevela/all.svg?style=flat-square)](https://github.com/oam-dev/kubevela/releases)
+[![TODOs](https://img.shields.io/endpoint?url=https://api.tickgit.com/badge?repo=github.com/oam-dev/kubevela)](https://www.tickgit.com/browse?repo=github.com/oam-dev/kubevela)
+[![Twitter](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Ftwitter.com%2Foam_dev)](https://twitter.com/oam_dev)
+
+![alt](docs/resources/KubeVela-03.png)
 
 *Make shipping applications more enjoyable.*
 
@@ -15,11 +24,11 @@ For platform builders, KubeVela serves as a framework that empowers them to crea
 
 ## Quick Start
 
-Quick start guides are available on [this section](docs/quick-start.md).
+Quick start guides are available on [this section](https://kubevela.io/#/en/quick-start).
 
 ## Documentation
 
-To see full documentation, visit [kubevela.io](https://kubevela.io/).
+For full documentation, please visit the KubeVela website: [https://kubevela.io](https://kubevela.io/).
 
 ## Contributing
 Check out [CONTRIBUTING](./CONTRIBUTING.md) to see how to develop with KubeVela.

api/core.oam.dev/v1alpha2/groupversion_info.go

@@ -1,35 +0,0 @@
-/*
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-// Package v1alpha2 contains API Schema definitions for the core.oam.dev v1alpha2 API group
-// +kubebuilder:object:generate=true
-// +groupName=core.oam.dev
-package v1alpha2
-
-import (
-	"k8s.io/apimachinery/pkg/runtime/schema"
-	"sigs.k8s.io/controller-runtime/pkg/scheme"
-)
-
-var (
-	// SchemeGroupVersion is group version used to register these objects
-	SchemeGroupVersion = schema.GroupVersion{Group: "core.oam.dev", Version: "v1alpha2"}
-
-	// SchemeBuilder is used to add go types to the GroupVersionKind scheme
-	SchemeBuilder = &scheme.Builder{GroupVersion: SchemeGroupVersion}
-
-	// AddToScheme adds the types in this group-version to the given scheme.
-	AddToScheme = SchemeBuilder.AddToScheme
-)

api/core.oam.dev/v1alpha2/zz_generated.deepcopy.go

@@ -1,115 +0,0 @@
-// +build !ignore_autogenerated
-
-/*
-
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-// Code generated by controller-gen. DO NOT EDIT.
-
-package v1alpha2
-
-import (
-	runtime "k8s.io/apimachinery/pkg/runtime"
-)
-
-// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
-func (in *ApplicationDeployment) DeepCopyInto(out *ApplicationDeployment) {
-	*out = *in
-	out.TypeMeta = in.TypeMeta
-	in.ObjectMeta.DeepCopyInto(&out.ObjectMeta)
-	out.Spec = in.Spec
-	in.Status.DeepCopyInto(&out.Status)
-}
-
-// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ApplicationDeployment.
-func (in *ApplicationDeployment) DeepCopy() *ApplicationDeployment {
-	if in == nil {
-		return nil
-	}
-	out := new(ApplicationDeployment)
-	in.DeepCopyInto(out)
-	return out
-}
-
-// DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
-func (in *ApplicationDeployment) DeepCopyObject() runtime.Object {
-	if c := in.DeepCopy(); c != nil {
-		return c
-	}
-	return nil
-}
-
-// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
-func (in *ApplicationDeploymentList) DeepCopyInto(out *ApplicationDeploymentList) {
-	*out = *in
-	out.TypeMeta = in.TypeMeta
-	in.ListMeta.DeepCopyInto(&out.ListMeta)
-	if in.Items != nil {
-		in, out := &in.Items, &out.Items
-		*out = make([]ApplicationDeployment, len(*in))
-		for i := range *in {
-			(*in)[i].DeepCopyInto(&(*out)[i])
-		}
-	}
-}
-
-// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ApplicationDeploymentList.
-func (in *ApplicationDeploymentList) DeepCopy() *ApplicationDeploymentList {
-	if in == nil {
-		return nil
-	}
-	out := new(ApplicationDeploymentList)
-	in.DeepCopyInto(out)
-	return out
-}
-
-// DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
-func (in *ApplicationDeploymentList) DeepCopyObject() runtime.Object {
-	if c := in.DeepCopy(); c != nil {
-		return c
-	}
-	return nil
-}
-
-// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
-func (in *ApplicationDeploymentSpec) DeepCopyInto(out *ApplicationDeploymentSpec) {
-	*out = *in
-}
-
-// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ApplicationDeploymentSpec.
-func (in *ApplicationDeploymentSpec) DeepCopy() *ApplicationDeploymentSpec {
-	if in == nil {
-		return nil
-	}
-	out := new(ApplicationDeploymentSpec)
-	in.DeepCopyInto(out)
-	return out
-}
-
-// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
-func (in *ApplicationDeploymentStatus) DeepCopyInto(out *ApplicationDeploymentStatus) {
-	*out = *in
-	in.ConditionedStatus.DeepCopyInto(&out.ConditionedStatus)
-}
-
-// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ApplicationDeploymentStatus.
-func (in *ApplicationDeploymentStatus) DeepCopy() *ApplicationDeploymentStatus {
-	if in == nil {
-		return nil
-	}
-	out := new(ApplicationDeploymentStatus)
-	in.DeepCopyInto(out)
-	return out
-}

api/types/args.go

@@ -1,11 +0,0 @@
-package types
-
-import (
-	"k8s.io/apimachinery/pkg/runtime"
-	"k8s.io/client-go/rest"
-)
-
-type Args struct {
-	Config *rest.Config
-	Schema *runtime.Scheme
-}

api/types/types.go

@@ -1,46 +0,0 @@
-package types
-
-const (
-	DefaultOAMNS               = "vela-system"
-	DefaultOAMReleaseName      = "kubevela"
-	DefaultOAMRuntimeChartName = "vela-core"
-	DefaultOAMVersion          = ">0.0.0-0"
-
-	DefaultEnvName      = "default"
-	DefaultAppNamespace = "default"
-)
-
-const (
-	AnnAPIVersion  = "definition.oam.dev/apiVersion"
-	AnnKind        = "definition.oam.dev/kind"
-	AnnDescription = "definition.oam.dev/description"
-
-	LabelPodSpecable = "workload.oam.dev/podspecable"
-)
-
-const (
-	StatusDeployed = "Deployed"
-	StatusStaging  = "Staging"
-)
-
-type EnvMeta struct {
-	Name      string `json:"name"`
-	Namespace string `json:"namespace"`
-	Email     string `json:"email,omitempty"`
-	Domain    string `json:"domain,omitempty"`
-
-	// Below are not arguments, should be auto-generated
-	Issuer  string `json:"issuer"`
-	Current string `json:"current,omitempty"`
-}
-
-const (
-	TagCommandType = "commandType"
-
-	TypeStart   = "Getting Started"
-	TypeApp     = "Applications"
-	TypeTraits  = "Traits"
-	TypeRelease = "Release"
-	TypeOthers  = "Others"
-	TypeSystem  = "System"
-)

apis/apis.go

@@ -0,0 +1,2 @@
+// Package apis contains all api types of KubeVela
+package apis

apis/core.oam.dev/groupversion_info.go

@@ -0,0 +1,37 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package core_oam_dev contains API Schema definitions for the core.oam.dev v1alpha2 API group
+package core_oam_dev
+
+import (
+	"k8s.io/apimachinery/pkg/runtime"
+
+	"github.com/oam-dev/kubevela/apis/core.oam.dev/v1alpha2"
+)
+
+func init() {
+	// Register the types with the Scheme so the resources can map objects to GroupVersionKinds and back
+	AddToSchemes = append(AddToSchemes, v1alpha2.SchemeBuilder.AddToScheme)
+}
+
+// AddToSchemes may be used to add all resources defined in the project to a Scheme
+var AddToSchemes runtime.SchemeBuilder
+
+// AddToScheme adds all Resources to the Scheme
+func AddToScheme(s *runtime.Scheme) error {
+	return AddToSchemes.AddToScheme(s)
+}

apis/core.oam.dev/v1alpha2/appdeploy_types.go

@@ -1,5 +1,5 @@
 /*
-
+Copyright 2020 The KubeVela Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -25,19 +25,19 @@ import (
 
 // ApplicationDeploymentSpec defines the desired state of ApplicationDeployment
 type ApplicationDeploymentSpec struct {
-	//TODO add spec here
+	// TODO add spec here
 }
 
 // ApplicationDeploymentStatus defines the observed state of ApplicationDeployment
 type ApplicationDeploymentStatus struct {
-	//TODO add status field here
+	// TODO add status field here
 	runtimev1alpha1.ConditionedStatus `json:",inline"`
 }
 
+// ApplicationDeployment is the Schema for the ApplicationDeployment API
 // +kubebuilder:object:root=true
 // +kubebuilder:resource:categories={oam}
 // +kubebuilder:subresource:status
-// ApplicationDeployment is the Schema for the ApplicationDeployment API
 type ApplicationDeployment struct {
 	metav1.TypeMeta   `json:",inline"`
 	metav1.ObjectMeta `json:"metadata,omitempty"`
@@ -46,14 +46,10 @@ type ApplicationDeployment struct {
 	Status ApplicationDeploymentStatus `json:"status,omitempty"`
 }
 
-// +kubebuilder:object:root=true
 // ApplicationDeploymentList contains a list of ApplicationDeployment
+// +kubebuilder:object:root=true
 type ApplicationDeploymentList struct {
 	metav1.TypeMeta `json:",inline"`
 	metav1.ListMeta `json:"metadata,omitempty"`
 	Items           []ApplicationDeployment `json:"items"`
 }
-
-func init() {
-	SchemeBuilder.Register(&ApplicationDeployment{}, &ApplicationDeploymentList{})
-}

apis/core.oam.dev/v1alpha2/application_types.go

@@ -0,0 +1,73 @@
+/*
+
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package v1alpha2
+
+import (
+	"k8s.io/apimachinery/pkg/runtime"
+
+	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+)
+
+// EDIT THIS FILE!  THIS IS SCAFFOLDING FOR YOU TO OWN!
+// NOTE: json tags are required.  Any new fields you add must have json tags for the fields to be serialized.
+
+// ApplicationPhase is a label for the condition of a application at the current time
+type ApplicationPhase string
+
+const (
+	// ApplicationRendering means the app is rendering
+	ApplicationRendering ApplicationPhase = "rendering"
+	// ApplicationRunning means the app finished rendering and applied result to the cluster
+	ApplicationRunning ApplicationPhase = "running"
+)
+
+// AppStatus defines the observed state of Application
+type AppStatus struct {
+	// INSERT ADDITIONAL STATUS FIELD - define observed state of cluster
+	// Important: Run "make" to regenerate code after modifying this file
+
+	runtimev1alpha1.ConditionedStatus `json:",inline"`
+
+	Phase ApplicationPhase `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// Application is the Schema for the applications API
+// +kubebuilder:subresource:status
+type Application struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	// +kubebuilder:pruning:PreserveUnknownFields
+	Spec   runtime.RawExtension `json:"spec,omitempty"`
+	Status AppStatus            `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// ApplicationList contains a list of Application
+type ApplicationList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []Application `json:"items"`
+}
+
+func init() {
+	SchemeBuilder.Register(&Application{}, &ApplicationList{})
+}

apis/core.oam.dev/v1alpha2/core_scope_types.go

@@ -0,0 +1,104 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package v1alpha2
+
+import (
+	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+
+	"github.com/oam-dev/kubevela/pkg/oam"
+)
+
+// HealthStatus represents health status strings.
+type HealthStatus string
+
+const (
+	// StatusHealthy represents healthy status.
+	StatusHealthy HealthStatus = "HEALTHY"
+	// StatusUnhealthy represents unhealthy status.
+	StatusUnhealthy = "UNHEALTHY"
+	// StatusUnknown represents unknown status.
+	StatusUnknown = "UNKNOWN"
+)
+
+var _ oam.Scope = &HealthScope{}
+
+// A HealthScopeSpec defines the desired state of a HealthScope.
+type HealthScopeSpec struct {
+	// ProbeTimeout is the amount of time in seconds to wait when receiving a response before marked failure.
+	ProbeTimeout *int32 `json:"probe-timeout,omitempty"`
+
+	// ProbeInterval is the amount of time in seconds between probing tries.
+	ProbeInterval *int32 `json:"probe-interval,omitempty"`
+
+	// WorkloadReferences to the workloads that are in this scope.
+	WorkloadReferences []runtimev1alpha1.TypedReference `json:"workloadRefs"`
+}
+
+// A HealthScopeStatus represents the observed state of a HealthScope.
+type HealthScopeStatus struct {
+	runtimev1alpha1.ConditionedStatus `json:",inline"`
+
+	// ScopeHealthCondition represents health condition summary of the scope
+	ScopeHealthCondition ScopeHealthCondition `json:"scopeHealthCondition"`
+
+	// WorkloadHealthConditions represents health condition of workloads in the scope
+	WorkloadHealthConditions []*WorkloadHealthCondition `json:"healthConditions,omitempty"`
+}
+
+// ScopeHealthCondition represents health condition summary of a scope.
+type ScopeHealthCondition struct {
+	HealthStatus       HealthStatus `json:"healthStatus"`
+	Total              int64        `json:"total,omitempty"`
+	HealthyWorkloads   int64        `json:"healthyWorkloads,omitempty"`
+	UnhealthyWorkloads int64        `json:"unhealthyWorkloads,omitempty"`
+	UnknownWorkloads   int64        `json:"unknownWorkloads,omitempty"`
+}
+
+// WorkloadHealthCondition represents informative health condition.
+type WorkloadHealthCondition struct {
+	// ComponentName represents the component name if target is a workload
+	ComponentName  string                         `json:"componentName,omitempty"`
+	TargetWorkload runtimev1alpha1.TypedReference `json:"targetWorkload,omitempty"`
+	HealthStatus   HealthStatus                   `json:"healthStatus"`
+	Diagnosis      string                         `json:"diagnosis,omitempty"`
+	// WorkloadStatus represents status of workloads whose HealthStatus is UNKNOWN.
+	WorkloadStatus string `json:"workloadStatus,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// A HealthScope determines an aggregate health status based of the health of components.
+// +kubebuilder:resource:categories={crossplane,oam}
+// +kubebuilder:subresource:status
+// +kubebuilder:printcolumn:JSONPath=".status.health",name=HEALTH,type=string
+type HealthScope struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   HealthScopeSpec   `json:"spec,omitempty"`
+	Status HealthScopeStatus `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// HealthScopeList contains a list of HealthScope.
+type HealthScopeList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []HealthScope `json:"items"`
+}

apis/core.oam.dev/v1alpha2/core_trait_types.go

@@ -0,0 +1,63 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package v1alpha2
+
+import (
+	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+
+	"github.com/oam-dev/kubevela/pkg/oam"
+)
+
+var _ oam.Trait = &ManualScalerTrait{}
+
+// A ManualScalerTraitSpec defines the desired state of a ManualScalerTrait.
+type ManualScalerTraitSpec struct {
+	// ReplicaCount of the workload this trait applies to.
+	ReplicaCount int32 `json:"replicaCount"`
+
+	// WorkloadReference to the workload this trait applies to.
+	WorkloadReference runtimev1alpha1.TypedReference `json:"workloadRef"`
+}
+
+// A ManualScalerTraitStatus represents the observed state of a
+// ManualScalerTrait.
+type ManualScalerTraitStatus struct {
+	runtimev1alpha1.ConditionedStatus `json:",inline"`
+}
+
+// +kubebuilder:object:root=true
+
+// A ManualScalerTrait determines how many replicas a workload should have.
+// +kubebuilder:resource:categories={crossplane,oam}
+// +kubebuilder:subresource:status
+type ManualScalerTrait struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   ManualScalerTraitSpec   `json:"spec,omitempty"`
+	Status ManualScalerTraitStatus `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// ManualScalerTraitList contains a list of ManualScalerTrait.
+type ManualScalerTraitList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []ManualScalerTrait `json:"items"`
+}

apis/core.oam.dev/v1alpha2/core_types.go

@@ -0,0 +1,548 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package v1alpha2
+
+import (
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/runtime"
+	"k8s.io/apimachinery/pkg/util/intstr"
+
+	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
+)
+
+// A DefinitionReference refers to a CustomResourceDefinition by name.
+type DefinitionReference struct {
+	// Name of the referenced CustomResourceDefinition.
+	Name string `json:"name"`
+
+	// Version indicate which version should be used if CRD has multiple versions
+	// by default it will use the first one if not specified
+	Version string `json:"version,omitempty"`
+}
+
+// A ChildResourceKind defines a child Kubernetes resource kind with a selector
+type ChildResourceKind struct {
+	// APIVersion of the child resource
+	APIVersion string `json:"apiVersion"`
+
+	// Kind of the child resource
+	Kind string `json:"kind"`
+
+	// Selector to select the child resources that the workload wants to expose to traits
+	Selector map[string]string `json:"selector,omitempty"`
+}
+
+// A WorkloadDefinitionSpec defines the desired state of a WorkloadDefinition.
+type WorkloadDefinitionSpec struct {
+	// Reference to the CustomResourceDefinition that defines this workload kind.
+	Reference DefinitionReference `json:"definitionRef"`
+
+	// ChildResourceKinds are the list of GVK of the child resources this workload generates
+	ChildResourceKinds []ChildResourceKind `json:"childResourceKinds,omitempty"`
+
+	// RevisionLabel indicates which label for underlying resources(e.g. pods) of this workload
+	// can be used by trait to create resource selectors(e.g. label selector for pods).
+	// +optional
+	RevisionLabel string `json:"revisionLabel,omitempty"`
+
+	// PodSpecPath indicates where/if this workload has K8s podSpec field
+	// if one workload has podSpec, trait can do lot's of assumption such as port, env, volume fields.
+	// +optional
+	PodSpecPath string `json:"podSpecPath,omitempty"`
+
+	// Extension is used for extension needs by OAM platform builders
+	// +optional
+	// +kubebuilder:pruning:PreserveUnknownFields
+	Extension *runtime.RawExtension `json:"extension,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// A WorkloadDefinition registers a kind of Kubernetes custom resource as a
+// valid OAM workload kind by referencing its CustomResourceDefinition. The CRD
+// is used to validate the schema of the workload when it is embedded in an OAM
+// Component.
+// +kubebuilder:printcolumn:JSONPath=".spec.definitionRef.name",name=DEFINITION-NAME,type=string
+// +kubebuilder:resource:scope=Cluster,categories={crossplane,oam}
+type WorkloadDefinition struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec WorkloadDefinitionSpec `json:"spec,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// WorkloadDefinitionList contains a list of WorkloadDefinition.
+type WorkloadDefinitionList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []WorkloadDefinition `json:"items"`
+}
+
+// A TraitDefinitionSpec defines the desired state of a TraitDefinition.
+type TraitDefinitionSpec struct {
+	// Reference to the CustomResourceDefinition that defines this trait kind.
+	Reference DefinitionReference `json:"definitionRef"`
+
+	// Revision indicates whether a trait is aware of component revision
+	// +optional
+	RevisionEnabled bool `json:"revisionEnabled,omitempty"`
+
+	// WorkloadRefPath indicates where/if a trait accepts a workloadRef object
+	// +optional
+	WorkloadRefPath string `json:"workloadRefPath,omitempty"`
+
+	// AppliesToWorkloads specifies the list of workload kinds this trait
+	// applies to. Workload kinds are specified in kind.group/version format,
+	// e.g. server.core.oam.dev/v1alpha2. Traits that omit this field apply to
+	// all workload kinds.
+	// +optional
+	AppliesToWorkloads []string `json:"appliesToWorkloads,omitempty"`
+
+	// Extension is used for extension needs by OAM platform builders
+	// +optional
+	// +kubebuilder:pruning:PreserveUnknownFields
+	Extension *runtime.RawExtension `json:"extension,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// A TraitDefinition registers a kind of Kubernetes custom resource as a valid
+// OAM trait kind by referencing its CustomResourceDefinition. The CRD is used
+// to validate the schema of the trait when it is embedded in an OAM
+// ApplicationConfiguration.
+// +kubebuilder:printcolumn:JSONPath=".spec.definitionRef.name",name=DEFINITION-NAME,type=string
+// +kubebuilder:resource:scope=Cluster,categories={crossplane,oam}
+type TraitDefinition struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec TraitDefinitionSpec `json:"spec,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// TraitDefinitionList contains a list of TraitDefinition.
+type TraitDefinitionList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []TraitDefinition `json:"items"`
+}
+
+// A ScopeDefinitionSpec defines the desired state of a ScopeDefinition.
+type ScopeDefinitionSpec struct {
+	// Reference to the CustomResourceDefinition that defines this scope kind.
+	Reference DefinitionReference `json:"definitionRef"`
+
+	// WorkloadRefsPath indicates if/where a scope accepts workloadRef objects
+	WorkloadRefsPath string `json:"workloadRefsPath,omitempty"`
+
+	// AllowComponentOverlap specifies whether an OAM component may exist in
+	// multiple instances of this kind of scope.
+	AllowComponentOverlap bool `json:"allowComponentOverlap"`
+
+	// Extension is used for extension needs by OAM platform builders
+	// +optional
+	// +kubebuilder:pruning:PreserveUnknownFields
+	Extension *runtime.RawExtension `json:"extension,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// A ScopeDefinition registers a kind of Kubernetes custom resource as a valid
+// OAM scope kind by referencing its CustomResourceDefinition. The CRD is used
+// to validate the schema of the scope when it is embedded in an OAM
+// ApplicationConfiguration.
+// +kubebuilder:printcolumn:JSONPath=".spec.definitionRef.name",name=DEFINITION-NAME,type=string
+// +kubebuilder:resource:scope=Cluster,categories={crossplane,oam}
+type ScopeDefinition struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec ScopeDefinitionSpec `json:"spec,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// ScopeDefinitionList contains a list of ScopeDefinition.
+type ScopeDefinitionList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []ScopeDefinition `json:"items"`
+}
+
+// A ComponentParameter defines a configurable parameter of a component.
+type ComponentParameter struct {
+	// Name of this parameter. OAM ApplicationConfigurations will specify
+	// parameter values using this name.
+	Name string `json:"name"`
+
+	// FieldPaths specifies an array of fields within this Component's workload
+	// that will be overwritten by the value of this parameter. The type of the
+	// parameter (e.g. int, string) is inferred from the type of these fields;
+	// All fields must be of the same type. Fields are specified as JSON field
+	// paths without a leading dot, for example 'spec.replicas'.
+	FieldPaths []string `json:"fieldPaths"`
+
+	// +kubebuilder:default:=false
+	// Required specifies whether or not a value for this parameter must be
+	// supplied when authoring an ApplicationConfiguration.
+	// +optional
+	Required *bool `json:"required,omitempty"`
+
+	// Description of this parameter.
+	// +optional
+	Description *string `json:"description,omitempty"`
+}
+
+// A ComponentSpec defines the desired state of a Component.
+type ComponentSpec struct {
+	// A Workload that will be created for each ApplicationConfiguration that
+	// includes this Component. Workload is an instance of a workloadDefinition.
+	// We either use the GVK info or a special "type" field in the workload to associate
+	// the content of the workload with its workloadDefinition
+	// +kubebuilder:validation:EmbeddedResource
+	// +kubebuilder:pruning:PreserveUnknownFields
+	Workload runtime.RawExtension `json:"workload"`
+
+	// Parameters exposed by this component. ApplicationConfigurations that
+	// reference this component may specify values for these parameters, which
+	// will in turn be injected into the embedded workload.
+	// +optional
+	Parameters []ComponentParameter `json:"parameters,omitempty"`
+}
+
+// A ComponentStatus represents the observed state of a Component.
+type ComponentStatus struct {
+	// The generation observed by the component controller.
+	// +optional
+	ObservedGeneration int64 `json:"observedGeneration"`
+
+	runtimev1alpha1.ConditionedStatus `json:",inline"`
+
+	// LatestRevision of component
+	// +optional
+	LatestRevision *Revision `json:"latestRevision,omitempty"`
+
+	// One Component should only be used by one AppConfig
+}
+
+// Revision has name and revision number
+type Revision struct {
+	Name     string `json:"name"`
+	Revision int64  `json:"revision"`
+}
+
+// +kubebuilder:object:root=true
+
+// A Component describes how an OAM workload kind may be instantiated.
+// +kubebuilder:resource:categories={crossplane,oam}
+// +kubebuilder:subresource:status
+// +kubebuilder:printcolumn:JSONPath=".spec.workload.kind",name=WORKLOAD-KIND,type=string
+// +kubebuilder:printcolumn:name="age",type="date",JSONPath=".metadata.creationTimestamp"
+type Component struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   ComponentSpec   `json:"spec,omitempty"`
+	Status ComponentStatus `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// ComponentList contains a list of Component.
+type ComponentList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []Component `json:"items"`
+}
+
+// A ComponentParameterValue specifies a value for a named parameter. The
+// associated component must publish a parameter with this name.
+type ComponentParameterValue struct {
+	// Name of the component parameter to set.
+	Name string `json:"name"`
+
+	// Value to set.
+	Value intstr.IntOrString `json:"value"`
+}
+
+// A ComponentTrait specifies a trait that should be applied to a component.
+type ComponentTrait struct {
+	// A Trait that will be created for the component
+	// +kubebuilder:validation:EmbeddedResource
+	// +kubebuilder:pruning:PreserveUnknownFields
+	Trait runtime.RawExtension `json:"trait"`
+
+	// DataOutputs specify the data output sources from this trait.
+	// +optional
+	DataOutputs []DataOutput `json:"dataOutputs,omitempty"`
+
+	// DataInputs specify the data input sinks into this trait.
+	// +optional
+	DataInputs []DataInput `json:"dataInputs,omitempty"`
+}
+
+// A ComponentScope specifies a scope in which a component should exist.
+type ComponentScope struct {
+	// A ScopeReference must refer to an OAM scope resource.
+	ScopeReference runtimev1alpha1.TypedReference `json:"scopeRef"`
+}
+
+// An ApplicationConfigurationComponent specifies a component of an
+// ApplicationConfiguration. Each component is used to instantiate a workload.
+type ApplicationConfigurationComponent struct {
+	// ComponentName specifies a component whose latest revision will be bind
+	// with ApplicationConfiguration. When the spec of the referenced component
+	// changes, ApplicationConfiguration will automatically migrate all trait
+	// affect from the prior revision to the new one. This is mutually exclusive
+	// with RevisionName.
+	// +optional
+	ComponentName string `json:"componentName,omitempty"`
+
+	// RevisionName of a specific component revision to which to bind
+	// ApplicationConfiguration. This is mutually exclusive with componentName.
+	// +optional
+	RevisionName string `json:"revisionName,omitempty"`
+
+	// DataOutputs specify the data output sources from this component.
+	DataOutputs []DataOutput `json:"dataOutputs,omitempty"`
+
+	// DataInputs specify the data input sinks into this component.
+	DataInputs []DataInput `json:"dataInputs,omitempty"`
+
+	// ParameterValues specify values for the the specified component's
+	// parameters. Any parameter required by the component must be specified.
+	// +optional
+	ParameterValues []ComponentParameterValue `json:"parameterValues,omitempty"`
+
+	// Traits of the specified component.
+	// +optional
+	Traits []ComponentTrait `json:"traits,omitempty"`
+
+	// Scopes in which the specified component should exist.
+	// +optional
+	Scopes []ComponentScope `json:"scopes,omitempty"`
+}
+
+// An ApplicationConfigurationSpec defines the desired state of a
+// ApplicationConfiguration.
+type ApplicationConfigurationSpec struct {
+	// Components of which this ApplicationConfiguration consists. Each
+	// component will be used to instantiate a workload.
+	Components []ApplicationConfigurationComponent `json:"components"`
+}
+
+// A TraitStatus represents the state of a trait.
+type TraitStatus string
+
+// A WorkloadTrait represents a trait associated with a workload and its status
+type WorkloadTrait struct {
+	// Status is a place holder for a customized controller to fill
+	// if it needs a single place to summarize the status of the trait
+	Status TraitStatus `json:"status,omitempty"`
+
+	// Reference to a trait created by an ApplicationConfiguration.
+	Reference runtimev1alpha1.TypedReference `json:"traitRef"`
+
+	// Message will allow controller to leave some additional information for this trait
+	Message string `json:"message,omitempty"`
+}
+
+// A ScopeStatus represents the state of a scope.
+type ScopeStatus string
+
+// A WorkloadScope represents a scope associated with a workload and its status
+type WorkloadScope struct {
+	// Status is a place holder for a customized controller to fill
+	// if it needs a single place to summarize the status of the scope
+	Status ScopeStatus `json:"status,omitempty"`
+
+	// Reference to a scope created by an ApplicationConfiguration.
+	Reference runtimev1alpha1.TypedReference `json:"scopeRef"`
+}
+
+// A WorkloadStatus represents the status of a workload.
+type WorkloadStatus struct {
+	// Status is a place holder for a customized controller to fill
+	// if it needs a single place to summarize the entire status of the workload
+	Status string `json:"status,omitempty"`
+
+	// ComponentName that produced this workload.
+	ComponentName string `json:"componentName,omitempty"`
+
+	// ComponentRevisionName of current component
+	ComponentRevisionName string `json:"componentRevisionName,omitempty"`
+
+	// Reference to a workload created by an ApplicationConfiguration.
+	Reference runtimev1alpha1.TypedReference `json:"workloadRef,omitempty"`
+
+	// Traits associated with this workload.
+	Traits []WorkloadTrait `json:"traits,omitempty"`
+
+	// Scopes associated with this workload.
+	Scopes []WorkloadScope `json:"scopes,omitempty"`
+}
+
+// HistoryWorkload contain the old component revision that are still running
+type HistoryWorkload struct {
+	// Revision of this workload
+	Revision string `json:"revision,omitempty"`
+
+	// Reference to running workload.
+	Reference runtimev1alpha1.TypedReference `json:"workloadRef,omitempty"`
+}
+
+// A ApplicationStatus represents the state of the entire application.
+type ApplicationStatus string
+
+// An ApplicationConfigurationStatus represents the observed state of a
+// ApplicationConfiguration.
+type ApplicationConfigurationStatus struct {
+	runtimev1alpha1.ConditionedStatus `json:",inline"`
+
+	// Status is a place holder for a customized controller to fill
+	// if it needs a single place to summarize the status of the entire application
+	Status ApplicationStatus `json:"status,omitempty"`
+
+	Dependency DependencyStatus `json:"dependency,omitempty"`
+
+	// Workloads created by this ApplicationConfiguration.
+	Workloads []WorkloadStatus `json:"workloads,omitempty"`
+
+	// The generation observed by the appConfig controller.
+	// +optional
+	ObservedGeneration int64 `json:"observedGeneration"`
+
+	// HistoryWorkloads will record history but still working revision workloads.
+	HistoryWorkloads []HistoryWorkload `json:"historyWorkloads,omitempty"`
+}
+
+// DependencyStatus represents the observed state of the dependency of
+// an ApplicationConfiguration.
+type DependencyStatus struct {
+	Unsatisfied []UnstaifiedDependency `json:"unsatisfied,omitempty"`
+}
+
+// UnstaifiedDependency describes unsatisfied dependency flow between
+// one pair of objects.
+type UnstaifiedDependency struct {
+	Reason string               `json:"reason"`
+	From   DependencyFromObject `json:"from"`
+	To     DependencyToObject   `json:"to"`
+}
+
+// DependencyFromObject represents the object that dependency data comes from.
+type DependencyFromObject struct {
+	runtimev1alpha1.TypedReference `json:",inline"`
+	FieldPath                      string `json:"fieldPath,omitempty"`
+}
+
+// DependencyToObject represents the object that dependency data goes to.
+type DependencyToObject struct {
+	runtimev1alpha1.TypedReference `json:",inline"`
+	FieldPaths                     []string `json:"fieldPaths,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// An ApplicationConfiguration represents an OAM application.
+// +kubebuilder:resource:shortName=appconfig,categories={crossplane,oam}
+// +kubebuilder:subresource:status
+type ApplicationConfiguration struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   ApplicationConfigurationSpec   `json:"spec,omitempty"`
+	Status ApplicationConfigurationStatus `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// ApplicationConfigurationList contains a list of ApplicationConfiguration.
+type ApplicationConfigurationList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []ApplicationConfiguration `json:"items"`
+}
+
+// DataOutput specifies a data output source from an object.
+type DataOutput struct {
+	// Name is the unique name of a DataOutput in an ApplicationConfiguration.
+	Name string `json:"name,omitempty"`
+
+	// FieldPath refers to the value of an object's field.
+	FieldPath string `json:"fieldPath,omitempty"`
+
+	// Conditions specify the conditions that should be satisfied before emitting a data output.
+	// Different conditions are AND-ed together.
+	// If no conditions is specified, it is by default to check output value not empty.
+	// +optional
+	Conditions []ConditionRequirement `json:"conditions,omitempty"`
+}
+
+// DataInput specifies a data input sink to an object.
+// If input is array, it will be appended to the target field paths.
+type DataInput struct {
+	// ValueFrom specifies the value source.
+	ValueFrom DataInputValueFrom `json:"valueFrom,omitempty"`
+
+	// ToFieldPaths specifies the field paths of an object to fill passed value.
+	ToFieldPaths []string `json:"toFieldPaths,omitempty"`
+}
+
+// DataInputValueFrom specifies the value source for a data input.
+type DataInputValueFrom struct {
+	// DataOutputName matches a name of a DataOutput in the same AppConfig.
+	DataOutputName string `json:"dataOutputName"`
+}
+
+// ConditionRequirement specifies the requirement to match a value.
+type ConditionRequirement struct {
+	Operator ConditionOperator `json:"op"`
+
+	// +optional
+	// Value specifies an expected value
+	// This is mutually exclusive with ValueFrom
+	Value string `json:"value,omitempty"`
+	// +optional
+	// ValueFrom specifies expected value from AppConfig
+	// This is mutually exclusive with Value
+	ValueFrom ValueFrom `json:"valueFrom,omitempty"`
+
+	// +optional
+	// FieldPath specifies got value from workload/trait object
+	FieldPath string `json:"fieldPath,omitempty"`
+}
+
+// ValueFrom gets value from AppConfig object by specifying a path
+type ValueFrom struct {
+	FieldPath string `json:"fieldPath"`
+}
+
+// ConditionOperator specifies the operator to match a value.
+type ConditionOperator string
+
+const (
+	// ConditionEqual indicates equal to given value
+	ConditionEqual ConditionOperator = "eq"
+	// ConditionNotEqual indicates not equal to given value
+	ConditionNotEqual ConditionOperator = "notEq"
+	// ConditionNotEmpty indicates given value not empty
+	ConditionNotEmpty ConditionOperator = "notEmpty"
+)

apis/core.oam.dev/v1alpha2/core_workload_types.go

@@ -0,0 +1,409 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package v1alpha2
+
+package v1alpha2
+
+import (
+	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
+	"k8s.io/apimachinery/pkg/api/resource"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/util/intstr"
+
+	"github.com/oam-dev/kubevela/pkg/oam"
+)
+
+// An OperatingSystem required by a containerised workload.
+type OperatingSystem string
+
+// Supported operating system types.
+const (
+	OperatingSystemLinux   OperatingSystem = "linux"
+	OperatingSystemWindows OperatingSystem = "windows"
+)
+
+// A CPUArchitecture required by a containerised workload.
+type CPUArchitecture string
+
+// Supported architectures
+const (
+	CPUArchitectureI386  CPUArchitecture = "i386"
+	CPUArchitectureAMD64 CPUArchitecture = "amd64"
+	CPUArchitectureARM   CPUArchitecture = "arm"
+	CPUArchitectureARM64 CPUArchitecture = "arm64"
+)
+
+// A SecretKeySelector is a reference to a secret key in an arbitrary namespace.
+type SecretKeySelector struct {
+	// The name of the secret.
+	Name string `json:"name"`
+
+	// The key to select.
+	Key string `json:"key"`
+}
+
+// TODO(negz): The OAM spec calls for float64 quantities in some cases, but this
+// is incompatible with controller-gen and Kubernetes API conventions. We should
+// reassess whether resource.Quantity is appropriate after resolving
+// https://github.com/oam-dev/spec/issues/313
+
+// CPUResources required by a container.
+type CPUResources struct {
+	// Required CPU count. 1.0 represents one CPU core.
+	Required resource.Quantity `json:"required"`
+}
+
+// MemoryResources required by a container.
+type MemoryResources struct {
+	// Required memory.
+	Required resource.Quantity `json:"required"`
+}
+
+// GPUResources required by a container.
+type GPUResources struct {
+	// Required GPU count.
+	Required resource.Quantity `json:"required"`
+}
+
+// DiskResource required by a container.
+type DiskResource struct {
+	// Required disk space.
+	Required resource.Quantity `json:"required"`
+
+	// Ephemeral specifies whether an external disk needs to be mounted.
+	// +optional
+	Ephemeral *bool `json:"ephemeral,omitempty"`
+}
+
+// A VolumeAccessMode determines how a volume may be accessed.
+type VolumeAccessMode string
+
+// Volume access modes.
+const (
+	VolumeAccessModeRO VolumeAccessMode = "RO"
+	VolumeAccessModeRW VolumeAccessMode = "RW"
+)
+
+// A VolumeSharingPolicy determines how a volume may be shared.
+type VolumeSharingPolicy string
+
+// Volume sharing policies.
+const (
+	VolumeSharingPolicyExclusive VolumeSharingPolicy = "Exclusive"
+	VolumeSharingPolicyShared    VolumeSharingPolicy = "Shared"
+)
+
+// VolumeResource required by a container.
+type VolumeResource struct {
+	// Name of this volume. Must be unique within its container.
+	Name string `json:"name"`
+
+	// MountPath at which this volume will be mounted within its container.
+	MountPath string `json:"mountPath"`
+
+	// TODO(negz): Use +kubebuilder:default marker to default AccessMode to RW
+	// and SharingPolicy to Exclusive once we're generating v1 CRDs.
+
+	// AccessMode of this volume; RO (read only) or RW (read and write).
+	// +optional
+	// +kubebuilder:validation:Enum=RO;RW
+	AccessMode *VolumeAccessMode `json:"accessMode,omitempty"`
+
+	// SharingPolicy of this volume; Exclusive or Shared.
+	// +optional
+	// +kubebuilder:validation:Enum=Exclusive;Shared
+	SharingPolicy *VolumeSharingPolicy `json:"sharingPolicy,omitempty"`
+
+	// Disk requirements of this volume.
+	// +optional
+	Disk *DiskResource `json:"disk,omitempty"`
+}
+
+// ExtendedResource required by a container.
+type ExtendedResource struct {
+	// Name of the external resource. Resource names are specified in
+	// kind.group/version format, e.g. motionsensor.ext.example.com/v1.
+	Name string `json:"name"`
+
+	// Required extended resource(s), e.g. 8 or "very-cool-widget"
+	Required intstr.IntOrString `json:"required"`
+}
+
+// ContainerResources specifies a container's required compute resources.
+type ContainerResources struct {
+	// CPU required by this container.
+	CPU CPUResources `json:"cpu"`
+
+	// Memory required by this container.
+	Memory MemoryResources `json:"memory"`
+
+	// GPU required by this container.
+	// +optional
+	GPU *GPUResources `json:"gpu,omitempty"`
+
+	// Volumes required by this container.
+	// +optional
+	Volumes []VolumeResource `json:"volumes,omitempty"`
+
+	// Extended resources required by this container.
+	// +optional
+	Extended []ExtendedResource `json:"extended,omitempty"`
+}
+
+// A ContainerEnvVar specifies an environment variable that should be set within
+// a container.
+type ContainerEnvVar struct {
+	// Name of the environment variable. Must be composed of valid Unicode
+	// letter and number characters, as well as _ and -.
+	// +kubebuilder:validation:Pattern=^[-_a-zA-Z0-9]+$
+	Name string `json:"name"`
+
+	// Value of the environment variable.
+	// +optional
+	Value *string `json:"value,omitempty"`
+
+	// FromSecret is a secret key reference which can be used to assign a value
+	// to the environment variable.
+	// +optional
+	FromSecret *SecretKeySelector `json:"fromSecret,omitempty"`
+}
+
+// A ContainerConfigFile specifies a configuration file that should be written
+// within a container.
+type ContainerConfigFile struct {
+	// Path within the container at which the configuration file should be
+	// written.
+	Path string `json:"path"`
+
+	// Value that should be written to the configuration file.
+	// +optional
+	Value *string `json:"value,omitempty"`
+
+	// FromSecret is a secret key reference which can be used to assign a value
+	// to be written to the configuration file at the given path in the
+	// container.
+	// +optional
+	FromSecret *SecretKeySelector `json:"fromSecret,omitempty"`
+}
+
+// A TransportProtocol represents a transport layer protocol.
+type TransportProtocol string
+
+// Transport protocols.
+const (
+	TransportProtocolTCP TransportProtocol = "TCP"
+	TransportProtocolUDP TransportProtocol = "UDP"
+)
+
+// A ContainerPort specifies a port that is exposed by a container.
+type ContainerPort struct {
+	// Name of this port. Must be unique within its container. Must be lowercase
+	// alphabetical characters.
+	// +kubebuilder:validation:Pattern=^[a-z]+$
+	Name string `json:"name"`
+
+	// Port number. Must be unique within its container.
+	Port int32 `json:"containerPort"`
+
+	// TODO(negz): Use +kubebuilder:default marker to default Protocol to TCP
+	// once we're generating v1 CRDs.
+
+	// Protocol used by the server listening on this port.
+	// +kubebuilder:validation:Enum=TCP;UDP
+	// +optional
+	Protocol *TransportProtocol `json:"protocol,omitempty"`
+}
+
+// An ExecProbe probes a container's health by executing a command.
+type ExecProbe struct {
+	// Command to be run by this probe.
+	Command []string `json:"command"`
+}
+
+// A HTTPHeader to be passed when probing a container.
+type HTTPHeader struct {
+	// Name of this HTTP header. Must be unique per probe.
+	Name string `json:"name"`
+
+	// Value of this HTTP header.
+	Value string `json:"value"`
+}
+
+// A HTTPGetProbe probes a container's health by sending an HTTP GET request.
+type HTTPGetProbe struct {
+	// Path to probe, e.g. '/healthz'.
+	Path string `json:"path"`
+
+	// Port to probe.
+	Port int32 `json:"port"`
+
+	// HTTPHeaders to send with the GET request.
+	// +optional
+	HTTPHeaders []HTTPHeader `json:"httpHeaders,omitempty"`
+}
+
+// A TCPSocketProbe probes a container's health by connecting to a TCP socket.
+type TCPSocketProbe struct {
+	// Port this probe should connect to.
+	Port int32 `json:"port"`
+}
+
+// A ContainerHealthProbe specifies how to probe the health of a container.
+// Exactly one of Exec, HTTPGet, or TCPSocket must be specified.
+type ContainerHealthProbe struct {
+	// Exec probes a container's health by executing a command.
+	// +optional
+	Exec *ExecProbe `json:"exec,omitempty"`
+
+	// HTTPGet probes a container's health by sending an HTTP GET request.
+	// +optional
+	HTTPGet *HTTPGetProbe `json:"httpGet,omitempty"`
+
+	// TCPSocketProbe probes a container's health by connecting to a TCP socket.
+	// +optional
+	TCPSocket *TCPSocketProbe `json:"tcpSocket,omitempty"`
+
+	// InitialDelaySeconds after a container starts before the first probe.
+	// +optional
+	InitialDelaySeconds *int32 `json:"initialDelaySeconds,omitempty"`
+
+	// TODO(negz): Use +kubebuilder:default marker to default PeriodSeconds,
+	// TimeoutSeconds, SuccessThreshold, and FailureThreshold to 10, 1, 1, and 3
+	// respectively once we're generating v1 CRDs.
+
+	// PeriodSeconds between probes.
+	// +optional
+	PeriodSeconds *int32 `json:"periodSeconds,omitempty"`
+
+	// TimeoutSeconds after which the probe times out.
+	// +optional
+	TimeoutSeconds *int32 `json:"timeoutSeconds,omitempty"`
+
+	// SuccessThreshold specifies how many consecutive probes must success in
+	// order for the container to be considered healthy.
+	// +optional
+	SuccessThreshold *int32 `json:"successThreshold,omitempty"`
+
+	// FailureThreshold specifies how many consecutive probes must fail in order
+	// for the container to be considered healthy.
+	// +optional
+	FailureThreshold *int32 `json:"failureThreshold,omitempty"`
+}
+
+// A Container represents an Open Containers Initiative (OCI) container.
+type Container struct {
+	// Name of this container. Must be unique within its workload.
+	Name string `json:"name"`
+
+	// Image this container should run. Must be a path-like or URI-like
+	// representation of an OCI image. May be prefixed with a registry address
+	// and should be suffixed with a tag.
+	Image string `json:"image"`
+
+	// Resources required by this container
+	// +optional
+	Resources *ContainerResources `json:"resources,omitempty"`
+
+	// Command to be run by this container.
+	// +optional
+	Command []string `json:"command,omitempty"`
+
+	// Arguments to be passed to the command run by this container.
+	// +optional
+	Arguments []string `json:"args,omitempty"`
+
+	// Environment variables that should be set within this container.
+	// +optional
+	Environment []ContainerEnvVar `json:"env,omitempty"`
+
+	// ConfigFiles that should be written within this container.
+	// +optional
+	ConfigFiles []ContainerConfigFile `json:"config,omitempty"`
+
+	// Ports exposed by this container.
+	// +optional
+	Ports []ContainerPort `json:"ports,omitempty"`
+
+	// A LivenessProbe assesses whether this container is alive. Containers that
+	// fail liveness probes will be restarted.
+	// +optional
+	LivenessProbe *ContainerHealthProbe `json:"livenessProbe,omitempty"`
+
+	// A ReadinessProbe assesses whether this container is ready to serve
+	// requests. Containers that fail readiness probes will be withdrawn from
+	// service.
+	// +optional
+	ReadinessProbe *ContainerHealthProbe `json:"readinessProbe,omitempty"`
+
+	// TODO(negz): Ideally the key within this secret would be configurable, but
+	// the current OAM spec allows only a secret name.
+
+	// ImagePullSecret specifies the name of a Secret from which the
+	// credentials required to pull this container's image can be loaded.
+	// +optional
+	ImagePullSecret *string `json:"imagePullSecret,omitempty"`
+}
+
+// A ContainerizedWorkloadSpec defines the desired state of a
+// ContainerizedWorkload.
+type ContainerizedWorkloadSpec struct {
+	// OperatingSystem required by this workload.
+	// +kubebuilder:validation:Enum=linux;windows
+	// +optional
+	OperatingSystem *OperatingSystem `json:"osType,omitempty"`
+
+	// CPUArchitecture required by this workload.
+	// +kubebuilder:validation:Enum=i386;amd64;arm;arm64
+	// +optional
+	CPUArchitecture *CPUArchitecture `json:"arch,omitempty"`
+
+	// Containers of which this workload consists.
+	Containers []Container `json:"containers"`
+}
+
+// A ContainerizedWorkloadStatus represents the observed state of a
+// ContainerizedWorkload.
+type ContainerizedWorkloadStatus struct {
+	runtimev1alpha1.ConditionedStatus `json:",inline"`
+
+	// Resources managed by this containerised workload.
+	Resources []runtimev1alpha1.TypedReference `json:"resources,omitempty"`
+}
+
+var _ oam.Workload = &ContainerizedWorkload{}
+
+// +kubebuilder:object:root=true
+
+// A ContainerizedWorkload is a workload that runs OCI containers.
+// +kubebuilder:resource:categories={crossplane,oam}
+// +kubebuilder:subresource:status
+type ContainerizedWorkload struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	Spec   ContainerizedWorkloadSpec   `json:"spec,omitempty"`
+	Status ContainerizedWorkloadStatus `json:"status,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+
+// ContainerizedWorkloadList contains a list of ContainerizedWorkload.
+type ContainerizedWorkloadList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []ContainerizedWorkload `json:"items"`
+}

apis/core.oam.dev/v1alpha2/doc.go

@@ -0,0 +1,22 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// Package v1alpha2 contains resources relating to the Open Application Model.
+// See https://github.com/oam-dev/spec for more details.
+// +kubebuilder:object:generate=true
+// +groupName=core.oam.dev
+// +versionName=v1alpha2
+package v1alpha2

apis/core.oam.dev/v1alpha2/methods.go

@@ -0,0 +1,93 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+// This code is manually implemented, but should be generated in the future.
+
+package v1alpha2
+
+import (
+	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
+)
+
+// GetCondition of this ManualScalerTrait.
+func (tr *ManualScalerTrait) GetCondition(ct runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
+	return tr.Status.GetCondition(ct)
+}
+
+// SetConditions of this ManualScalerTrait.
+func (tr *ManualScalerTrait) SetConditions(c ...runtimev1alpha1.Condition) {
+	tr.Status.SetConditions(c...)
+}
+
+// GetWorkloadReference of this ManualScalerTrait.
+func (tr *ManualScalerTrait) GetWorkloadReference() runtimev1alpha1.TypedReference {
+	return tr.Spec.WorkloadReference
+}
+
+// SetWorkloadReference of this ManualScalerTrait.
+func (tr *ManualScalerTrait) SetWorkloadReference(r runtimev1alpha1.TypedReference) {
+	tr.Spec.WorkloadReference = r
+}
+
+// GetCondition of this ApplicationConfiguration.
+func (ac *ApplicationConfiguration) GetCondition(ct runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
+	return ac.Status.GetCondition(ct)
+}
+
+// SetConditions of this ApplicationConfiguration.
+func (ac *ApplicationConfiguration) SetConditions(c ...runtimev1alpha1.Condition) {
+	ac.Status.SetConditions(c...)
+}
+
+// GetCondition of this Component.
+func (cm *Component) GetCondition(ct runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
+	return cm.Status.GetCondition(ct)
+}
+
+// SetConditions of this Component.
+func (cm *Component) SetConditions(c ...runtimev1alpha1.Condition) {
+	cm.Status.SetConditions(c...)
+}
+
+// GetCondition of this ContainerizedWorkload.
+func (wl *ContainerizedWorkload) GetCondition(ct runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
+	return wl.Status.GetCondition(ct)
+}
+
+// SetConditions of this ContainerizedWorkload.
+func (wl *ContainerizedWorkload) SetConditions(c ...runtimev1alpha1.Condition) {
+	wl.Status.SetConditions(c...)
+}
+
+// GetCondition of this HealthScope.
+func (hs *HealthScope) GetCondition(ct runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
+	return hs.Status.GetCondition(ct)
+}
+
+// SetConditions of this HealthScope.
+func (hs *HealthScope) SetConditions(c ...runtimev1alpha1.Condition) {
+	hs.Status.SetConditions(c...)
+}
+
+// GetWorkloadReferences to get all workload references for scope.
+func (hs *HealthScope) GetWorkloadReferences() []runtimev1alpha1.TypedReference {
+	return hs.Spec.WorkloadReferences
+}
+
+// AddWorkloadReference to add a workload reference to this scope.
+func (hs *HealthScope) AddWorkloadReference(r runtimev1alpha1.TypedReference) {
+	hs.Spec.WorkloadReferences = append(hs.Spec.WorkloadReferences, r)
+}

apis/core.oam.dev/v1alpha2/register.go

@@ -0,0 +1,114 @@
+/*
+Copyright 2020 The KubeVela Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package v1alpha2
+
+import (
+	"reflect"
+
+	"k8s.io/apimachinery/pkg/runtime/schema"
+	"sigs.k8s.io/controller-runtime/pkg/scheme"
+)
+
+// Package type metadata.
+const (
+	Group   = "core.oam.dev"
+	Version = "v1alpha2"
+)
+
+var (
+	// SchemeGroupVersion is group version used to register these objects
+	SchemeGroupVersion = schema.GroupVersion{Group: Group, Version: Version}
+
+	// SchemeBuilder is used to add go types to the GroupVersionKind scheme
+	SchemeBuilder = &scheme.Builder{GroupVersion: SchemeGroupVersion}
+)
+
+// WorkloadDefinition type metadata.
+var (
+	WorkloadDefinitionKind             = reflect.TypeOf(WorkloadDefinition{}).Name()
+	WorkloadDefinitionGroupKind        = schema.GroupKind{Group: Group, Kind: WorkloadDefinitionKind}.String()
+	WorkloadDefinitionKindAPIVersion   = WorkloadDefinitionKind + "." + SchemeGroupVersion.String()
+	WorkloadDefinitionGroupVersionKind = SchemeGroupVersion.WithKind(WorkloadDefinitionKind)
+)
+
+// TraitDefinition type metadata.
+var (
+	TraitDefinitionKind             = reflect.TypeOf(TraitDefinition{}).Name()
+	TraitDefinitionGroupKind        = schema.GroupKind{Group: Group, Kind: TraitDefinitionKind}.String()
+	TraitDefinitionKindAPIVersion   = TraitDefinitionKind + "." + SchemeGroupVersion.String()
+	TraitDefinitionGroupVersionKind = SchemeGroupVersion.WithKind(TraitDefinitionKind)
+)
+
+// ScopeDefinition type metadata.
+var (
+	ScopeDefinitionKind             = reflect.TypeOf(ScopeDefinition{}).Name()
+	ScopeDefinitionGroupKind        = schema.GroupKind{Group: Group, Kind: ScopeDefinitionKind}.String()
+	ScopeDefinitionKindAPIVersion   = ScopeDefinitionKind + "." + SchemeGroupVersion.String()
+	ScopeDefinitionGroupVersionKind = SchemeGroupVersion.WithKind(ScopeDefinitionKind)
+)
+
+// Component type metadata.
+var (
+	ComponentKind             = reflect.TypeOf(Component{}).Name()
+	ComponentGroupKind        = schema.GroupKind{Group: Group, Kind: ComponentKind}.String()
+	ComponentKindAPIVersion   = ComponentKind + "." + SchemeGroupVersion.String()
+	ComponentGroupVersionKind = SchemeGroupVersion.WithKind(ComponentKind)
+)
+
+// ApplicationConfiguration type metadata.
+var (
+	ApplicationConfigurationKind             = reflect.TypeOf(ApplicationConfiguration{}).Name()
+	ApplicationConfigurationGroupKind        = schema.GroupKind{Group: Group, Kind: ApplicationConfigurationKind}.String()
+	ApplicationConfigurationKindAPIVersion   = ApplicationConfigurationKind + "." + SchemeGroupVersion.String()
+	ApplicationConfigurationGroupVersionKind = SchemeGroupVersion.WithKind(ApplicationConfigurationKind)
+)
+
+// ContainerizedWorkload type metadata.
+var (
+	ContainerizedWorkloadKind             = reflect.TypeOf(ContainerizedWorkload{}).Name()
+	ContainerizedWorkloadGroupKind        = schema.GroupKind{Group: Group, Kind: ContainerizedWorkloadKind}.String()
+	ContainerizedWorkloadKindAPIVersion   = ContainerizedWorkloadKind + "." + SchemeGroupVersion.String()
+	ContainerizedWorkloadGroupVersionKind = SchemeGroupVersion.WithKind(ContainerizedWorkloadKind)
+)
+
+// ManualScalerTrait type metadata.
+var (
+	ManualScalerTraitKind             = reflect.TypeOf(ManualScalerTrait{}).Name()
+	ManualScalerTraitGroupKind        = schema.GroupKind{Group: Group, Kind: ManualScalerTraitKind}.String()
+	ManualScalerTraitKindAPIVersion   = ManualScalerTraitKind + "." + SchemeGroupVersion.String()
+	ManualScalerTraitGroupVersionKind = SchemeGroupVersion.WithKind(ManualScalerTraitKind)
+)
+
+// HealthScope type metadata.
+var (
+	HealthScopeKind             = reflect.TypeOf(HealthScope{}).Name()
+	HealthScopeGroupKind        = schema.GroupKind{Group: Group, Kind: HealthScopeKind}.String()
+	HealthScopeKindAPIVersion   = HealthScopeKind + "." + SchemeGroupVersion.String()
+	HealthScopeGroupVersionKind = SchemeGroupVersion.WithKind(HealthScopeKind)
+)
+
+func init() {
+	SchemeBuilder.Register(&WorkloadDefinition{}, &WorkloadDefinitionList{})
+	SchemeBuilder.Register(&TraitDefinition{}, &TraitDefinitionList{})
+	SchemeBuilder.Register(&ScopeDefinition{}, &ScopeDefinitionList{})
+	SchemeBuilder.Register(&Component{}, &ComponentList{})
+	SchemeBuilder.Register(&ApplicationConfiguration{}, &ApplicationConfigurationList{})
+	SchemeBuilder.Register(&ContainerizedWorkload{}, &ContainerizedWorkloadList{})
+	SchemeBuilder.Register(&ManualScalerTrait{}, &ManualScalerTraitList{})
+	SchemeBuilder.Register(&HealthScope{}, &HealthScopeList{})
+	SchemeBuilder.Register(&ApplicationDeployment{}, &ApplicationDeploymentList{})
+}

apis/generate.go

@@ -0,0 +1,21 @@
+// +build generate
+
+// See the below link for details on what is happening here.
+// https://github.com/golang/go/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module
+
+// NOTE(@wonderflow) We don't remove existing CRDs here, because the crd folders contain not only auto generated.
+
+// Generate deepcopy methodsets and CRD manifests
+//go:generate go run -tags generate sigs.k8s.io/controller-tools/cmd/controller-gen object:headerFile=../hack/boilerplate.go.txt paths=./... crd:crdVersions=v1 output:artifacts:config=../charts/vela-core/crds
+
+// Generate legacy_support for K8s 1.12~1.15 versions CRD manifests
+//go:generate go run -tags generate sigs.k8s.io/controller-tools/cmd/controller-gen object:headerFile=../hack/boilerplate.go.txt paths=./... crd:trivialVersions=true output:artifacts:config=../legacy/charts/vela-core-legacy/crds
+//go:generate go run ../legacy/convert/main.go ../legacy/charts/vela-core-legacy/crds
+
+//go:generate go run ../hack/crd/update.go ../charts/vela-core/crds/
+
+package apis
+
+import (
+	_ "sigs.k8s.io/controller-tools/cmd/controller-gen" //nolint:typecheck
+)

apis/standard.oam.dev/v1alpha1/autoscaler_types.go

@@ -30,9 +30,9 @@ type Protocol string
 // TriggerType defines the type of trigger
 type TriggerType string
 
+// Autoscaler is the Schema for the autoscalers API
 // +kubebuilder:object:root=true
 // +kubebuilder:resource:categories={oam}
-// Autoscaler is the Schema for the autoscalers API
 type Autoscaler struct {
 	metav1.TypeMeta   `json:",inline"`
 	metav1.ObjectMeta `json:"metadata,omitempty"`
@@ -41,18 +41,22 @@ type Autoscaler struct {
 	Status AutoscalerStatus `json:"status,omitempty"`
 }
 
+// SetConditions set condition for CR status
 func (as *Autoscaler) SetConditions(c ...v1alpha1.Condition) {
 	as.Status.SetConditions(c...)
 }
 
+// GetCondition get condition from CR status
 func (as *Autoscaler) GetCondition(conditionType v1alpha1.ConditionType) v1alpha1.Condition {
 	return as.Status.GetCondition(conditionType)
 }
 
+// GetWorkloadReference get workload reference
 func (as *Autoscaler) GetWorkloadReference() v1alpha1.TypedReference {
 	return as.Spec.WorkloadReference
 }
 
+// SetWorkloadReference set workload reference
 func (as *Autoscaler) SetWorkloadReference(reference v1alpha1.TypedReference) {
 	as.Spec.WorkloadReference = reference
 }

apis/standard.oam.dev/v1alpha1/metricstrait_types.go

@@ -18,9 +18,10 @@ package v1alpha1
 
 import (
 	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
-	"github.com/crossplane/oam-kubernetes-runtime/pkg/oam"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	"k8s.io/apimachinery/pkg/util/intstr"
+
+	"github.com/oam-dev/kubevela/pkg/oam"
 )
 
 // NOTE: json tags are required.  Any new fields you add must have json tags for the fields to be serialized.
@@ -99,20 +100,22 @@ func init() {
 
 var _ oam.Trait = &MetricsTrait{}
 
+// SetConditions for set CR condition
 func (tr *MetricsTrait) SetConditions(c ...runtimev1alpha1.Condition) {
 	tr.Status.SetConditions(c...)
 }
 
+// GetCondition for get CR condition
 func (tr *MetricsTrait) GetCondition(c runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
 	return tr.Status.GetCondition(c)
 }
 
-// GetWorkloadReference of this ManualScalerTrait.
+// GetWorkloadReference of this MetricsTrait.
 func (tr *MetricsTrait) GetWorkloadReference() runtimev1alpha1.TypedReference {
 	return tr.Spec.WorkloadReference
 }
 
-// SetWorkloadReference of this ManualScalerTrait.
+// SetWorkloadReference of this MetricsTrait.
 func (tr *MetricsTrait) SetWorkloadReference(r runtimev1alpha1.TypedReference) {
 	tr.Spec.WorkloadReference = r
 }

apis/standard.oam.dev/v1alpha1/podspecworkload_types.go

@@ -18,9 +18,10 @@ package v1alpha1
 
 import (
 	cpv1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
-	"github.com/crossplane/oam-kubernetes-runtime/pkg/oam"
 	v1 "k8s.io/api/core/v1"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+
+	"github.com/oam-dev/kubevela/pkg/oam"
 )
 
 // PodSpecWorkloadSpec defines the desired state of PodSpecWorkload
@@ -73,10 +74,12 @@ func init() {
 
 var _ oam.Workload = &PodSpecWorkload{}
 
+// SetConditions set condition for this CR
 func (in *PodSpecWorkload) SetConditions(c ...cpv1alpha1.Condition) {
 	in.Status.SetConditions(c...)
 }
 
+// GetCondition set condition for this CR
 func (in *PodSpecWorkload) GetCondition(c cpv1alpha1.ConditionType) cpv1alpha1.Condition {
 	return in.Status.GetCondition(c)
 }

apis/standard.oam.dev/v1alpha1/route_types.go

@@ -18,9 +18,10 @@ package v1alpha1
 
 import (
 	runtimev1alpha1 "github.com/crossplane/crossplane-runtime/apis/core/v1alpha1"
-	"github.com/crossplane/oam-kubernetes-runtime/pkg/oam"
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 	"k8s.io/apimachinery/pkg/util/intstr"
+
+	"github.com/oam-dev/kubevela/pkg/oam"
 )
 
 // NOTE: json tags are required.  Any new fields you add must have json tags for the fields to be serialized.
@@ -66,6 +67,7 @@ type Rule struct {
 	Backend *Backend `json:"backend,omitempty"`
 }
 
+// TLS defines certificate issuer and type for mTLS configuration
 type TLS struct {
 	IssuerName string `json:"issuerName,omitempty"`
 
@@ -74,13 +76,17 @@ type TLS struct {
 	Type IssuerType `json:"type,omitempty"`
 }
 
+// IssuerType defines the type of issuer
 type IssuerType string
 
 const (
-	ClusterIssuer   IssuerType = "ClusterIssuer"
+	// ClusterIssuer is a cluster level type of issuer
+	ClusterIssuer IssuerType = "ClusterIssuer"
+	// NamespaceIssuer is the default one
 	NamespaceIssuer IssuerType = "Issuer"
 )
 
+// Backend defines backend configure for route trait.
 // Route will automatically discover podSpec and label for BackendService.
 // If BackendService is already set, discovery won't work.
 // If BackendService is not set, the discovery mechanism will work.
@@ -109,10 +115,10 @@ type RouteStatus struct {
 	runtimev1alpha1.ConditionedStatus `json:",inline"`
 }
 
+// Route is the Schema for the routes API
 // +kubebuilder:object:root=true
 // +kubebuilder:resource:categories={oam}
 // +kubebuilder:subresource:status
-// Route is the Schema for the routes API
 type Route struct {
 	metav1.TypeMeta   `json:",inline"`
 	metav1.ObjectMeta `json:"metadata,omitempty"`
@@ -121,8 +127,8 @@ type Route struct {
 	Status RouteStatus `json:"status,omitempty"`
 }
 
-// +kubebuilder:object:root=true
 // RouteList contains a list of Route
+// +kubebuilder:object:root=true
 type RouteList struct {
 	metav1.TypeMeta `json:",inline"`
 	metav1.ListMeta `json:"metadata,omitempty"`
@@ -135,20 +141,22 @@ func init() {
 
 var _ oam.Trait = &Route{}
 
+// SetConditions set condition for CR status
 func (r *Route) SetConditions(c ...runtimev1alpha1.Condition) {
 	r.Status.SetConditions(c...)
 }
 
+// GetCondition get condition from CR status
 func (r *Route) GetCondition(c runtimev1alpha1.ConditionType) runtimev1alpha1.Condition {
 	return r.Status.GetCondition(c)
 }
 
-// GetWorkloadReference of this ManualScalerTrait.
+// GetWorkloadReference of this Route Trait.
 func (r *Route) GetWorkloadReference() runtimev1alpha1.TypedReference {
 	return r.Spec.WorkloadReference
 }
 
-// SetWorkloadReference of this ManualScalerTrait.
+// SetWorkloadReference of this Route Trait.
 func (r *Route) SetWorkloadReference(rt runtimev1alpha1.TypedReference) {
 	r.Spec.WorkloadReference = rt
 }

apis/standard.oam.dev/v1alpha1/zz_generated.deepcopy.go

@@ -1,7 +1,7 @@
 // +build !ignore_autogenerated
 
 /*
-
+Copyright 2020 The KubeVela Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

apis/types/args.go

@@ -0,0 +1,23 @@
+package types
+
+import (
+	"k8s.io/apimachinery/pkg/runtime"
+	"k8s.io/client-go/rest"
+	"sigs.k8s.io/controller-runtime/pkg/client/config"
+)
+
+// Args is args for controller-runtime client
+type Args struct {
+	Config *rest.Config
+	Schema *runtime.Scheme
+}
+
+// SetConfig insert kubeconfig into Args
+func (a *Args) SetConfig() error {
+	restConf, err := config.GetConfig()
+	if err != nil {
+		return err
+	}
+	a.Config = restConf
+	return nil
+}

apis/types/capability.go

@@ -26,12 +26,14 @@ import (
 	"k8s.io/apimachinery/pkg/runtime"
 )
 
+// Source record the source of Capability
 type Source struct {
 	RepoName  string `json:"repoName"`
 	ChartName string `json:"chartName,omitempty"`
 }
 
-type CrdInfo struct {
+// CRDInfo record the CRD info of the Capability
+type CRDInfo struct {
 	APIVersion string `json:"apiVersion"`
 	Kind       string `json:"kind"`
 }
@@ -49,35 +51,44 @@ type Capability struct {
 	Status         string      `json:"status,omitempty"`
 	Description    string      `json:"description,omitempty"`
 
-	//trait only
+	// trait only
 	AppliesTo []string `json:"appliesTo,omitempty"`
 
 	// Plugin Source
 	Source  *Source       `json:"source,omitempty"`
 	Install *Installation `json:"install,omitempty"`
-	CrdInfo *CrdInfo      `json:"crdInfo,omitempty"`
+	CrdInfo *CRDInfo      `json:"crdInfo,omitempty"`
 }
 
+// Chart defines all necessary information to install a whole chart
 type Chart struct {
-	Repo      string `json:"repo"`
-	URL       string `json:"url"`
-	Name      string `json:"name"`
-	Namespace string `json:"namespace,omitempty"`
-	Version   string `json:"version"`
+	Repo      string                 `json:"repo"`
+	URL       string                 `json:"url"`
+	Name      string                 `json:"name"`
+	Namespace string                 `json:"namespace,omitempty"`
+	Version   string                 `json:"version"`
+	Values    map[string]interface{} `json:"values"`
 }
 
+// Installation defines the installation method for this Capability, currently only helm is supported
 type Installation struct {
 	Helm Chart `json:"helm"`
+	// TODO(wonderflow) add raw yaml file support for install capability
 }
 
+// CapType defines the type of capability
 type CapType string
 
 const (
+	// TypeWorkload represents OAM Workload
 	TypeWorkload CapType = "workload"
-	TypeTrait    CapType = "trait"
-	TypeScope    CapType = "scope"
+	// TypeTrait represents OAM Trait
+	TypeTrait CapType = "trait"
+	// TypeScope represent OAM Scope
+	TypeScope CapType = "scope"
 )
 
+// Parameter defines a parameter for cli from capability template
 type Parameter struct {
 	Name     string      `json:"name"`
 	Short    string      `json:"short,omitempty"`
@@ -92,11 +103,8 @@ type Parameter struct {
 func ConvertTemplateJSON2Object(in *runtime.RawExtension) (Capability, error) {
 	var t Capability
 	var extension Capability
-	if in == nil {
-		return t, fmt.Errorf("extension field is nil")
-	}
-	if in.Raw == nil {
-		return t, fmt.Errorf("template object is nil")
+	if in == nil || in.Raw == nil {
+		return t, fmt.Errorf("no template found")
 	}
 	err := json.Unmarshal(in.Raw, &extension)
 	if err == nil {
@@ -105,11 +113,13 @@ func ConvertTemplateJSON2Object(in *runtime.RawExtension) (Capability, error) {
 	return t, err
 }
 
+// SetFlagBy set cli flag from Parameter
 func SetFlagBy(flags *pflag.FlagSet, v Parameter) {
 	name := v.Name
 	if v.Alias != "" {
 		name = v.Alias
 	}
+	// nolint:exhaustive
 	switch v.Type {
 	case cue.IntKind:
 		var vv int64
@@ -141,15 +151,19 @@ func SetFlagBy(flags *pflag.FlagSet, v Parameter) {
 			vv = val
 		}
 		flags.Float64P(name, v.Short, vv, v.Usage)
+	default:
+		// other types not supported yet
 	}
 }
 
+// CapabilityCmpOptions will set compare option
 var CapabilityCmpOptions = []cmp.Option{
 	cmp.Comparer(func(a, b Parameter) bool {
 		if a.Name != b.Name || a.Short != b.Short || a.Required != b.Required ||
 			a.Usage != b.Usage || a.Type != b.Type {
 			return false
 		}
+		// nolint:exhaustive
 		switch a.Type {
 		case cue.IntKind:
 			var va, vb int64
@@ -188,7 +202,7 @@ var CapabilityCmpOptions = []cmp.Option{
 			case int:
 				va = float64(vala)
 			case float64:
-				va = float64(vala)
+				va = vala
 			}
 			switch valb := b.Default.(type) {
 			case int64:
@@ -198,13 +212,16 @@ var CapabilityCmpOptions = []cmp.Option{
 			case int:
 				vb = float64(valb)
 			case float64:
-				vb = float64(valb)
+				vb = valb
 			}
 			return va == vb
+		default:
+			// complex type not supported, will regard them as not changed.
 		}
 		return true
 	})}
 
+// EqualCapability will check whether two capabilities is equal
 func EqualCapability(a, b Capability) bool {
 	return cmp.Equal(a, b, CapabilityCmpOptions...)
 }

apis/types/types.go

@@ -0,0 +1,53 @@
+package types
+
+const (
+	// DefaultKubeVelaNS defines the default KubeVela namespace in Kubernetes
+	DefaultKubeVelaNS = "vela-system"
+	// DefaultKubeVelaReleaseName defines the default name of KubeVela Release
+	DefaultKubeVelaReleaseName = "kubevela"
+	// DefaultKubeVelaChartName defines the default chart name of KubeVela, this variable MUST align to the chart name of this repo
+	DefaultKubeVelaChartName = "vela-core"
+	// DefaultKubeVelaVersion defines the default version needed for KubeVela chart
+	DefaultKubeVelaVersion = ">0.0.0-0"
+	// DefaultEnvName defines the default environment name for Apps created by KubeVela
+	DefaultEnvName = "default"
+	// DefaultAppNamespace defines the default K8s namespace for Apps created by KubeVela
+	DefaultAppNamespace = "default"
+)
+
+const (
+	// AnnDescription is the annotation which describe what is the capability used for in a WorkloadDefinition/TraitDefinition Object
+	AnnDescription = "definition.oam.dev/description"
+)
+
+const (
+	// StatusDeployed represents the App was deployed
+	StatusDeployed = "Deployed"
+	// StatusStaging represents the App was changed locally and it's spec is diff from the deployed one, or not deployed at all
+	StatusStaging = "Staging"
+)
+
+// EnvMeta stores the info for app environment
+type EnvMeta struct {
+	Name      string `json:"name"`
+	Namespace string `json:"namespace"`
+	Email     string `json:"email,omitempty"`
+	Domain    string `json:"domain,omitempty"`
+
+	// Below are not arguments, should be auto-generated
+	Issuer  string `json:"issuer"`
+	Current string `json:"current,omitempty"`
+}
+
+const (
+	// TagCommandType used for tag cli category
+	TagCommandType = "commandType"
+	// TypeStart defines one category
+	TypeStart = "Getting Started"
+	// TypeApp defines one category
+	TypeApp = "Managing Applications"
+	// TypeCap defines one category
+	TypeCap = "Managing Capabilities"
+	// TypeSystem defines one category
+	TypeSystem = "System"
+)

charts/vela-core/crds/core.oam.dev_applicationconfigurations.yaml

@@ -27,47 +27,31 @@ spec:
         description: An ApplicationConfiguration represents an OAM application.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
           spec:
-            description: An ApplicationConfigurationSpec defines the desired state
-              of a ApplicationConfiguration.
+            description: An ApplicationConfigurationSpec defines the desired state of a ApplicationConfiguration.
             properties:
               components:
-                description: Components of which this ApplicationConfiguration consists.
-                  Each component will be used to instantiate a workload.
+                description: Components of which this ApplicationConfiguration consists. Each component will be used to instantiate a workload.
                 items:
-                  description: An ApplicationConfigurationComponent specifies a component
-                    of an ApplicationConfiguration. Each component is used to instantiate
-                    a workload.
+                  description: An ApplicationConfigurationComponent specifies a component of an ApplicationConfiguration. Each component is used to instantiate a workload.
                   properties:
                     componentName:
-                      description: ComponentName specifies a component whose latest
-                        revision will be bind with ApplicationConfiguration. When
-                        the spec of the referenced component changes, ApplicationConfiguration
-                        will automatically migrate all trait affect from the prior
-                        revision to the new one. This is mutually exclusive with RevisionName.
+                      description: ComponentName specifies a component whose latest revision will be bind with ApplicationConfiguration. When the spec of the referenced component changes, ApplicationConfiguration will automatically migrate all trait affect from the prior revision to the new one. This is mutually exclusive with RevisionName.
                       type: string
                     dataInputs:
-                      description: DataInputs specify the data input sinks into this
-                        component.
+                      description: DataInputs specify the data input sinks into this component.
                       items:
-                        description: DataInput specifies a data input sink to an object.
-                          If input is array, it will be appended to the target field
-                          paths.
+                        description: DataInput specifies a data input sink to an object. If input is array, it will be appended to the target field paths.
                         properties:
                           toFieldPaths:
-                            description: ToFieldPaths specifies the field paths of
-                              an object to fill passed value.
+                            description: ToFieldPaths specifies the field paths of an object to fill passed value.
                             items:
                               type: string
                             type: array
@@ -75,8 +59,7 @@ spec:
                             description: ValueFrom specifies the value source.
                             properties:
                               dataOutputName:
-                                description: DataOutputName matches a name of a DataOutput
-                                  in the same AppConfig.
+                                description: DataOutputName matches a name of a DataOutput in the same AppConfig.
                                 type: string
                             required:
                             - dataOutputName
@@ -84,38 +67,26 @@ spec:
                         type: object
                       type: array
                     dataOutputs:
-                      description: DataOutputs specify the data output sources from
-                        this component.
+                      description: DataOutputs specify the data output sources from this component.
                       items:
-                        description: DataOutput specifies a data output source from
-                          an object.
+                        description: DataOutput specifies a data output source from an object.
                         properties:
                           conditions:
-                            description: Conditions specify the conditions that should
-                              be satisfied before emitting a data output. Different
-                              conditions are AND-ed together. If no conditions is
-                              specified, it is by default to check output value not
-                              empty.
+                            description: Conditions specify the conditions that should be satisfied before emitting a data output. Different conditions are AND-ed together. If no conditions is specified, it is by default to check output value not empty.
                             items:
-                              description: ConditionRequirement specifies the requirement
-                                to match a value.
+                              description: ConditionRequirement specifies the requirement to match a value.
                               properties:
                                 fieldPath:
-                                  description: FieldPath specifies got value from
-                                    workload/trait object
+                                  description: FieldPath specifies got value from workload/trait object
                                   type: string
                                 op:
-                                  description: ConditionOperator specifies the operator
-                                    to match a value.
+                                  description: ConditionOperator specifies the operator to match a value.
                                   type: string
                                 value:
-                                  description: Value specifies an expected value This
-                                    is mutually exclusive with ValueFrom
+                                  description: Value specifies an expected value This is mutually exclusive with ValueFrom
                                   type: string
                                 valueFrom:
-                                  description: ValueFrom specifies expected value
-                                    from AppConfig This is mutually exclusive with
-                                    Value
+                                  description: ValueFrom specifies expected value from AppConfig This is mutually exclusive with Value
                                   properties:
                                     fieldPath:
                                       type: string
@@ -127,23 +98,17 @@ spec:
                               type: object
                             type: array
                           fieldPath:
-                            description: FieldPath refers to the value of an object's
-                              field.
+                            description: FieldPath refers to the value of an object's field.
                             type: string
                           name:
-                            description: Name is the unique name of a DataOutput in
-                              an ApplicationConfiguration.
+                            description: Name is the unique name of a DataOutput in an ApplicationConfiguration.
                             type: string
                         type: object
                       type: array
                     parameterValues:
-                      description: ParameterValues specify values for the the specified
-                        component's parameters. Any parameter required by the component
-                        must be specified.
+                      description: ParameterValues specify values for the the specified component's parameters. Any parameter required by the component must be specified.
                       items:
-                        description: A ComponentParameterValue specifies a value for
-                          a named parameter. The associated component must publish
-                          a parameter with this name.
+                        description: A ComponentParameterValue specifies a value for a named parameter. The associated component must publish a parameter with this name.
                         properties:
                           name:
                             description: Name of the component parameter to set.
@@ -160,20 +125,15 @@ spec:
                         type: object
                       type: array
                     revisionName:
-                      description: RevisionName of a specific component revision to
-                        which to bind ApplicationConfiguration. This is mutually exclusive
-                        with componentName.
+                      description: RevisionName of a specific component revision to which to bind ApplicationConfiguration. This is mutually exclusive with componentName.
                       type: string
                     scopes:
-                      description: Scopes in which the specified component should
-                        exist.
+                      description: Scopes in which the specified component should exist.
                       items:
-                        description: A ComponentScope specifies a scope in which a
-                          component should exist.
+                        description: A ComponentScope specifies a scope in which a component should exist.
                         properties:
                           scopeRef:
-                            description: A ScopeReference must refer to an OAM scope
-                              resource.
+                            description: A ScopeReference must refer to an OAM scope resource.
                             properties:
                               apiVersion:
                                 description: APIVersion of the referenced object.
@@ -199,20 +159,15 @@ spec:
                     traits:
                       description: Traits of the specified component.
                       items:
-                        description: A ComponentTrait specifies a trait that should
-                          be applied to a component.
+                        description: A ComponentTrait specifies a trait that should be applied to a component.
                         properties:
                           dataInputs:
-                            description: DataInputs specify the data input sinks into
-                              this trait.
+                            description: DataInputs specify the data input sinks into this trait.
                             items:
-                              description: DataInput specifies a data input sink to
-                                an object. If input is array, it will be appended
-                                to the target field paths.
+                              description: DataInput specifies a data input sink to an object. If input is array, it will be appended to the target field paths.
                               properties:
                                 toFieldPaths:
-                                  description: ToFieldPaths specifies the field paths
-                                    of an object to fill passed value.
+                                  description: ToFieldPaths specifies the field paths of an object to fill passed value.
                                   items:
                                     type: string
                                   type: array
@@ -220,8 +175,7 @@ spec:
                                   description: ValueFrom specifies the value source.
                                   properties:
                                     dataOutputName:
-                                      description: DataOutputName matches a name of
-                                        a DataOutput in the same AppConfig.
+                                      description: DataOutputName matches a name of a DataOutput in the same AppConfig.
                                       type: string
                                   required:
                                   - dataOutputName
@@ -229,38 +183,26 @@ spec:
                               type: object
                             type: array
                           dataOutputs:
-                            description: DataOutputs specify the data output sources
-                              from this trait.
+                            description: DataOutputs specify the data output sources from this trait.
                             items:
-                              description: DataOutput specifies a data output source
-                                from an object.
+                              description: DataOutput specifies a data output source from an object.
                               properties:
                                 conditions:
-                                  description: Conditions specify the conditions that
-                                    should be satisfied before emitting a data output.
-                                    Different conditions are AND-ed together. If no
-                                    conditions is specified, it is by default to check
-                                    output value not empty.
+                                  description: Conditions specify the conditions that should be satisfied before emitting a data output. Different conditions are AND-ed together. If no conditions is specified, it is by default to check output value not empty.
                                   items:
-                                    description: ConditionRequirement specifies the
-                                      requirement to match a value.
+                                    description: ConditionRequirement specifies the requirement to match a value.
                                     properties:
                                       fieldPath:
-                                        description: FieldPath specifies got value
-                                          from workload/trait object
+                                        description: FieldPath specifies got value from workload/trait object
                                         type: string
                                       op:
-                                        description: ConditionOperator specifies the
-                                          operator to match a value.
+                                        description: ConditionOperator specifies the operator to match a value.
                                         type: string
                                       value:
-                                        description: Value specifies an expected value
-                                          This is mutually exclusive with ValueFrom
+                                        description: Value specifies an expected value This is mutually exclusive with ValueFrom
                                         type: string
                                       valueFrom:
-                                        description: ValueFrom specifies expected
-                                          value from AppConfig This is mutually exclusive
-                                          with Value
+                                        description: ValueFrom specifies expected value from AppConfig This is mutually exclusive with Value
                                         properties:
                                           fieldPath:
                                             type: string
@@ -272,12 +214,10 @@ spec:
                                     type: object
                                   type: array
                                 fieldPath:
-                                  description: FieldPath refers to the value of an
-                                    object's field.
+                                  description: FieldPath refers to the value of an object's field.
                                   type: string
                                 name:
-                                  description: Name is the unique name of a DataOutput
-                                    in an ApplicationConfiguration.
+                                  description: Name is the unique name of a DataOutput in an ApplicationConfiguration.
                                   type: string
                               type: object
                             type: array
@@ -296,8 +236,7 @@ spec:
             - components
             type: object
           status:
-            description: An ApplicationConfigurationStatus represents the observed
-              state of a ApplicationConfiguration.
+            description: An ApplicationConfigurationStatus represents the observed state of a ApplicationConfiguration.
             properties:
               conditions:
                 description: Conditions of the resource.
@@ -305,25 +244,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime
@@ -333,17 +267,14 @@ spec:
                   type: object
                 type: array
               dependency:
-                description: DependencyStatus represents the observed state of the
-                  dependency of an ApplicationConfiguration.
+                description: DependencyStatus represents the observed state of the dependency of an ApplicationConfiguration.
                 properties:
                   unsatisfied:
                     items:
-                      description: UnstaifiedDependency describes unsatisfied dependency
-                        flow between one pair of objects.
+                      description: UnstaifiedDependency describes unsatisfied dependency flow between one pair of objects.
                       properties:
                         from:
-                          description: DependencyFromObject represents the object
-                            that dependency data comes from.
+                          description: DependencyFromObject represents the object that dependency data comes from.
                           properties:
                             apiVersion:
                               description: APIVersion of the referenced object.
@@ -367,8 +298,7 @@ spec:
                         reason:
                           type: string
                         to:
-                          description: DependencyToObject represents the object that
-                            dependency data goes to.
+                          description: DependencyToObject represents the object that dependency data goes to.
                           properties:
                             apiVersion:
                               description: APIVersion of the referenced object.
@@ -399,14 +329,12 @@ spec:
                     type: array
                 type: object
               historyWorkloads:
-                description: HistoryWorkloads will record history but still working
-                  revision workloads.
+                description: HistoryWorkloads will record history but still working revision workloads.
                 items:
-                  description: HistoryWorkload contain the old component revision
-                    that are still running
+                  description: HistoryWorkload contain the old component revision that are still running
                   properties:
                     revision:
-                      description: component revision of this workload
+                      description: Revision of this workload
                       type: string
                     workloadRef:
                       description: Reference to running workload.
@@ -435,9 +363,7 @@ spec:
                 format: int64
                 type: integer
               status:
-                description: Status is a place holder for a customized controller
-                  to fill if it needs a single place to summarize the status of the
-                  entire application
+                description: Status is a place holder for a customized controller to fill if it needs a single place to summarize the status of the entire application
                 type: string
               workloads:
                 description: Workloads created by this ApplicationConfiguration.
@@ -453,8 +379,7 @@ spec:
                     scopes:
                       description: Scopes associated with this workload.
                       items:
-                        description: A WorkloadScope represents a scope associated
-                          with a workload and its status
+                        description: A WorkloadScope represents a scope associated with a workload and its status
                         properties:
                           scopeRef:
                             description: Reference to a scope created by an ApplicationConfiguration.
@@ -477,29 +402,25 @@ spec:
                             - name
                             type: object
                           status:
-                            description: Status is a place holder for a customized
-                              controller to fill if it needs a single place to summarize
-                              the status of the scope
+                            description: Status is a place holder for a customized controller to fill if it needs a single place to summarize the status of the scope
                             type: string
                         required:
                         - scopeRef
                         type: object
                       type: array
                     status:
-                      description: Status is a place holder for a customized controller
-                        to fill if it needs a single place to summarize the entire
-                        status of the workload
+                      description: Status is a place holder for a customized controller to fill if it needs a single place to summarize the entire status of the workload
                       type: string
                     traits:
                       description: Traits associated with this workload.
                       items:
-                        description: A WorkloadTrait represents a trait associated
-                          with a workload and its status
+                        description: A WorkloadTrait represents a trait associated with a workload and its status
                         properties:
+                          message:
+                            description: Message will allow controller to leave some additional information for this trait
+                            type: string
                           status:
-                            description: Status is a place holder for a customized
-                              controller to fill if it needs a single place to summarize
-                              the status of the trait
+                            description: Status is a place holder for a customized controller to fill if it needs a single place to summarize the status of the trait
                             type: string
                           traitRef:
                             description: Reference to a trait created by an ApplicationConfiguration.

charts/vela-core/crds/core.oam.dev_applicationdeployments.yaml

@@ -4,7 +4,7 @@ apiVersion: apiextensions.k8s.io/v1
 kind: CustomResourceDefinition
 metadata:
   annotations:
-    controller-gen.kubebuilder.io/version: v0.2.5
+    controller-gen.kubebuilder.io/version: v0.2.4
   creationTimestamp: null
   name: applicationdeployments.core.oam.dev
 spec:
@@ -21,18 +21,13 @@ spec:
   - name: v1alpha2
     schema:
       openAPIV3Schema:
-        description: ApplicationDeployment is the Schema for the ApplicationDeployment
-          API
+        description: ApplicationDeployment is the Schema for the ApplicationDeployment API
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -40,8 +35,7 @@ spec:
             description: ApplicationDeploymentSpec defines the desired state of ApplicationDeployment
             type: object
           status:
-            description: ApplicationDeploymentStatus defines the observed state of
-              ApplicationDeployment
+            description: ApplicationDeploymentStatus defines the observed state of ApplicationDeployment
             properties:
               conditions:
                 description: Conditions of the resource.
@@ -49,25 +43,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime

charts/vela-core/crds/core.oam.dev_applications.yaml

@@ -0,0 +1,80 @@
+
+---
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+  annotations:
+    controller-gen.kubebuilder.io/version: v0.2.4
+  creationTimestamp: null
+  name: applications.core.oam.dev
+spec:
+  group: core.oam.dev
+  names:
+    kind: Application
+    listKind: ApplicationList
+    plural: applications
+    singular: application
+  scope: Namespaced
+  versions:
+  - name: v1alpha2
+    schema:
+      openAPIV3Schema:
+        description: Application is the Schema for the applications API
+        properties:
+          apiVersion:
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            type: string
+          kind:
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            type: string
+          metadata:
+            type: object
+          spec:
+            type: object
+            x-kubernetes-preserve-unknown-fields: true
+          status:
+            description: AppStatus defines the observed state of Application
+            properties:
+              conditions:
+                description: Conditions of the resource.
+                items:
+                  description: A Condition that may apply to a resource.
+                  properties:
+                    lastTransitionTime:
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
+                      format: date-time
+                      type: string
+                    message:
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
+                      type: string
+                    reason:
+                      description: A Reason for this condition's last transition from one status to another.
+                      type: string
+                    status:
+                      description: Status of this condition; is it currently True, False, or Unknown?
+                      type: string
+                    type:
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
+                      type: string
+                  required:
+                  - lastTransitionTime
+                  - reason
+                  - status
+                  - type
+                  type: object
+                type: array
+              status:
+                description: ApplicationPhase is a label for the condition of a application at the current time
+                type: string
+            type: object
+        type: object
+    served: true
+    storage: true
+    subresources:
+      status: {}
+status:
+  acceptedNames:
+    kind: ""
+    plural: ""
+  conditions: []
+  storedVersions: []

charts/vela-core/crds/core.oam.dev_components.yaml

@@ -32,14 +32,10 @@ spec:
         description: A Component describes how an OAM workload kind may be instantiated.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -47,34 +43,24 @@ spec:
             description: A ComponentSpec defines the desired state of a Component.
             properties:
               parameters:
-                description: Parameters exposed by this component. ApplicationConfigurations
-                  that reference this component may specify values for these parameters,
-                  which will in turn be injected into the embedded workload.
+                description: Parameters exposed by this component. ApplicationConfigurations that reference this component may specify values for these parameters, which will in turn be injected into the embedded workload.
                 items:
-                  description: A ComponentParameter defines a configurable parameter
-                    of a component.
+                  description: A ComponentParameter defines a configurable parameter of a component.
                   properties:
                     description:
                       description: Description of this parameter.
                       type: string
                     fieldPaths:
-                      description: FieldPaths specifies an array of fields within
-                        this Component's workload that will be overwritten by the
-                        value of this parameter. The type of the parameter (e.g. int,
-                        string) is inferred from the type of these fields; All fields
-                        must be of the same type. Fields are specified as JSON field
-                        paths without a leading dot, for example 'spec.replicas'.
+                      description: FieldPaths specifies an array of fields within this Component's workload that will be overwritten by the value of this parameter. The type of the parameter (e.g. int, string) is inferred from the type of these fields; All fields must be of the same type. Fields are specified as JSON field paths without a leading dot, for example 'spec.replicas'.
                       items:
                         type: string
                       type: array
                     name:
-                      description: Name of this parameter. OAM ApplicationConfigurations
-                        will specify parameter values using this name.
+                      description: Name of this parameter. OAM ApplicationConfigurations will specify parameter values using this name.
                       type: string
                     required:
                       default: false
-                      description: Required specifies whether or not a value for this
-                        parameter must be supplied when authoring an ApplicationConfiguration.
+                      description: Required specifies whether or not a value for this parameter must be supplied when authoring an ApplicationConfiguration.
                       type: boolean
                   required:
                   - fieldPaths
@@ -82,10 +68,7 @@ spec:
                   type: object
                 type: array
               workload:
-                description: A Workload that will be created for each ApplicationConfiguration
-                  that includes this Component. Workload is an instance of a workloadDefinition.
-                  We either use the GVK info or a special "type" field in the workload
-                  to associate the content of the workload with its workloadDefinition
+                description: A Workload that will be created for each ApplicationConfiguration that includes this Component. Workload is an instance of a workloadDefinition. We either use the GVK info or a special "type" field in the workload to associate the content of the workload with its workloadDefinition
                 type: object
                 x-kubernetes-embedded-resource: true
                 x-kubernetes-preserve-unknown-fields: true
@@ -101,25 +84,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime

charts/vela-core/crds/core.oam.dev_containerizedworkloads.yaml

@@ -25,20 +25,15 @@ spec:
         description: A ContainerizedWorkload is a workload that runs OCI containers.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
           spec:
-            description: A ContainerizedWorkloadSpec defines the desired state of
-              a ContainerizedWorkload.
+            description: A ContainerizedWorkloadSpec defines the desired state of a ContainerizedWorkload.
             properties:
               arch:
                 description: CPUArchitecture required by this workload.
@@ -51,12 +46,10 @@ spec:
               containers:
                 description: Containers of which this workload consists.
                 items:
-                  description: A Container represents an Open Containers Initiative
-                    (OCI) container.
+                  description: A Container represents an Open Containers Initiative (OCI) container.
                   properties:
                     args:
-                      description: Arguments to be passed to the command run by this
-                        container.
+                      description: Arguments to be passed to the command run by this container.
                       items:
                         type: string
                       type: array
@@ -66,16 +59,12 @@ spec:
                         type: string
                       type: array
                     config:
-                      description: ConfigFiles that should be written within this
-                        container.
+                      description: ConfigFiles that should be written within this container.
                       items:
-                        description: A ContainerConfigFile specifies a configuration
-                          file that should be written within a container.
+                        description: A ContainerConfigFile specifies a configuration file that should be written within a container.
                         properties:
                           fromSecret:
-                            description: FromSecret is a secret key reference which
-                              can be used to assign a value to be written to the configuration
-                              file at the given path in the container.
+                            description: FromSecret is a secret key reference which can be used to assign a value to be written to the configuration file at the given path in the container.
                             properties:
                               key:
                                 description: The key to select.
@@ -88,27 +77,22 @@ spec:
                             - name
                             type: object
                           path:
-                            description: Path within the container at which the configuration
-                              file should be written.
+                            description: Path within the container at which the configuration file should be written.
                             type: string
                           value:
-                            description: Value that should be written to the configuration
-                              file.
+                            description: Value that should be written to the configuration file.
                             type: string
                         required:
                         - path
                         type: object
                       type: array
                     env:
-                      description: Environment variables that should be set within
-                        this container.
+                      description: Environment variables that should be set within this container.
                       items:
-                        description: A ContainerEnvVar specifies an environment variable
-                          that should be set within a container.
+                        description: A ContainerEnvVar specifies an environment variable that should be set within a container.
                         properties:
                           fromSecret:
-                            description: FromSecret is a secret key reference which
-                              can be used to assign a value to the environment variable.
+                            description: FromSecret is a secret key reference which can be used to assign a value to the environment variable.
                             properties:
                               key:
                                 description: The key to select.
@@ -121,9 +105,7 @@ spec:
                             - name
                             type: object
                           name:
-                            description: Name of the environment variable. Must be
-                              composed of valid Unicode letter and number characters,
-                              as well as _ and -.
+                            description: Name of the environment variable. Must be composed of valid Unicode letter and number characters, as well as _ and -.
                             pattern: ^[-_a-zA-Z0-9]+$
                             type: string
                           value:
@@ -134,22 +116,16 @@ spec:
                         type: object
                       type: array
                     image:
-                      description: Image this container should run. Must be a path-like
-                        or URI-like representation of an OCI image. May be prefixed
-                        with a registry address and should be suffixed with a tag.
+                      description: Image this container should run. Must be a path-like or URI-like representation of an OCI image. May be prefixed with a registry address and should be suffixed with a tag.
                       type: string
                     imagePullSecret:
-                      description: ImagePullSecret specifies the name of a Secret
-                        from which the credentials required to pull this container's
-                        image can be loaded.
+                      description: ImagePullSecret specifies the name of a Secret from which the credentials required to pull this container's image can be loaded.
                       type: string
                     livenessProbe:
-                      description: A LivenessProbe assesses whether this container
-                        is alive. Containers that fail liveness probes will be restarted.
+                      description: A LivenessProbe assesses whether this container is alive. Containers that fail liveness probes will be restarted.
                       properties:
                         exec:
-                          description: Exec probes a container's health by executing
-                            a command.
+                          description: Exec probes a container's health by executing a command.
                           properties:
                             command:
                               description: Command to be run by this probe.
@@ -160,24 +136,19 @@ spec:
                           - command
                           type: object
                         failureThreshold:
-                          description: FailureThreshold specifies how many consecutive
-                            probes must fail in order for the container to be considered
-                            healthy.
+                          description: FailureThreshold specifies how many consecutive probes must fail in order for the container to be considered healthy.
                           format: int32
                           type: integer
                         httpGet:
-                          description: HTTPGet probes a container's health by sending
-                            an HTTP GET request.
+                          description: HTTPGet probes a container's health by sending an HTTP GET request.
                           properties:
                             httpHeaders:
                               description: HTTPHeaders to send with the GET request.
                               items:
-                                description: A HTTPHeader to be passed when probing
-                                  a container.
+                                description: A HTTPHeader to be passed when probing a container.
                                 properties:
                                   name:
-                                    description: Name of this HTTP header. Must be
-                                      unique per probe.
+                                    description: Name of this HTTP header. Must be unique per probe.
                                     type: string
                                   value:
                                     description: Value of this HTTP header.
@@ -199,8 +170,7 @@ spec:
                           - port
                           type: object
                         initialDelaySeconds:
-                          description: InitialDelaySeconds after a container starts
-                            before the first probe.
+                          description: InitialDelaySeconds after a container starts before the first probe.
                           format: int32
                           type: integer
                         periodSeconds:
@@ -208,14 +178,11 @@ spec:
                           format: int32
                           type: integer
                         successThreshold:
-                          description: SuccessThreshold specifies how many consecutive
-                            probes must success in order for the container to be considered
-                            healthy.
+                          description: SuccessThreshold specifies how many consecutive probes must success in order for the container to be considered healthy.
                           format: int32
                           type: integer
                         tcpSocket:
-                          description: TCPSocketProbe probes a container's health
-                            by connecting to a TCP socket.
+                          description: TCPSocketProbe probes a container's health by connecting to a TCP socket.
                           properties:
                             port:
                               description: Port this probe should connect to.
@@ -225,33 +192,28 @@ spec:
                           - port
                           type: object
                         timeoutSeconds:
-                          description: TimeoutSeconds after which the probe times
-                            out.
+                          description: TimeoutSeconds after which the probe times out.
                           format: int32
                           type: integer
                       type: object
                     name:
-                      description: Name of this container. Must be unique within its
-                        workload.
+                      description: Name of this container. Must be unique within its workload.
                       type: string
                     ports:
                       description: Ports exposed by this container.
                       items:
-                        description: A ContainerPort specifies a port that is exposed
-                          by a container.
+                        description: A ContainerPort specifies a port that is exposed by a container.
                         properties:
                           containerPort:
                             description: Port number. Must be unique within its container.
                             format: int32
                             type: integer
                           name:
-                            description: Name of this port. Must be unique within
-                              its container. Must be lowercase alphabetical characters.
+                            description: Name of this port. Must be unique within its container. Must be lowercase alphabetical characters.
                             pattern: ^[a-z]+$
                             type: string
                           protocol:
-                            description: Protocol used by the server listening on
-                              this port.
+                            description: Protocol used by the server listening on this port.
                             enum:
                             - TCP
                             - UDP
@@ -262,13 +224,10 @@ spec:
                         type: object
                       type: array
                     readinessProbe:
-                      description: A ReadinessProbe assesses whether this container
-                        is ready to serve requests. Containers that fail readiness
-                        probes will be withdrawn from service.
+                      description: A ReadinessProbe assesses whether this container is ready to serve requests. Containers that fail readiness probes will be withdrawn from service.
                       properties:
                         exec:
-                          description: Exec probes a container's health by executing
-                            a command.
+                          description: Exec probes a container's health by executing a command.
                           properties:
                             command:
                               description: Command to be run by this probe.
@@ -279,24 +238,19 @@ spec:
                           - command
                           type: object
                         failureThreshold:
-                          description: FailureThreshold specifies how many consecutive
-                            probes must fail in order for the container to be considered
-                            healthy.
+                          description: FailureThreshold specifies how many consecutive probes must fail in order for the container to be considered healthy.
                           format: int32
                           type: integer
                         httpGet:
-                          description: HTTPGet probes a container's health by sending
-                            an HTTP GET request.
+                          description: HTTPGet probes a container's health by sending an HTTP GET request.
                           properties:
                             httpHeaders:
                               description: HTTPHeaders to send with the GET request.
                               items:
-                                description: A HTTPHeader to be passed when probing
-                                  a container.
+                                description: A HTTPHeader to be passed when probing a container.
                                 properties:
                                   name:
-                                    description: Name of this HTTP header. Must be
-                                      unique per probe.
+                                    description: Name of this HTTP header. Must be unique per probe.
                                     type: string
                                   value:
                                     description: Value of this HTTP header.
@@ -318,8 +272,7 @@ spec:
                           - port
                           type: object
                         initialDelaySeconds:
-                          description: InitialDelaySeconds after a container starts
-                            before the first probe.
+                          description: InitialDelaySeconds after a container starts before the first probe.
                           format: int32
                           type: integer
                         periodSeconds:
@@ -327,14 +280,11 @@ spec:
                           format: int32
                           type: integer
                         successThreshold:
-                          description: SuccessThreshold specifies how many consecutive
-                            probes must success in order for the container to be considered
-                            healthy.
+                          description: SuccessThreshold specifies how many consecutive probes must success in order for the container to be considered healthy.
                           format: int32
                           type: integer
                         tcpSocket:
-                          description: TCPSocketProbe probes a container's health
-                            by connecting to a TCP socket.
+                          description: TCPSocketProbe probes a container's health by connecting to a TCP socket.
                           properties:
                             port:
                               description: Port this probe should connect to.
@@ -344,8 +294,7 @@ spec:
                           - port
                           type: object
                         timeoutSeconds:
-                          description: TimeoutSeconds after which the probe times
-                            out.
+                          description: TimeoutSeconds after which the probe times out.
                           format: int32
                           type: integer
                       type: object
@@ -356,8 +305,7 @@ spec:
                           description: CPU required by this container.
                           properties:
                             required:
-                              description: Required CPU count. 1.0 represents one
-                                CPU core.
+                              description: Required CPU count. 1.0 represents one CPU core.
                               type: string
                           required:
                           - required
@@ -368,16 +316,13 @@ spec:
                             description: ExtendedResource required by a container.
                             properties:
                               name:
-                                description: Name of the external resource. Resource
-                                  names are specified in kind.group/version format,
-                                  e.g. motionsensor.ext.example.com/v1.
+                                description: Name of the external resource. Resource names are specified in kind.group/version format, e.g. motionsensor.ext.example.com/v1.
                                 type: string
                               required:
                                 anyOf:
                                 - type: integer
                                 - type: string
-                                description: Required extended resource(s), e.g. 8
-                                  or "very-cool-widget"
+                                description: Required extended resource(s), e.g. 8 or "very-cool-widget"
                                 x-kubernetes-int-or-string: true
                             required:
                             - name
@@ -408,8 +353,7 @@ spec:
                             description: VolumeResource required by a container.
                             properties:
                               accessMode:
-                                description: AccessMode of this volume; RO (read only)
-                                  or RW (read and write).
+                                description: AccessMode of this volume; RO (read only) or RW (read and write).
                                 enum:
                                 - RO
                                 - RW
@@ -418,8 +362,7 @@ spec:
                                 description: Disk requirements of this volume.
                                 properties:
                                   ephemeral:
-                                    description: Ephemeral specifies whether an external
-                                      disk needs to be mounted.
+                                    description: Ephemeral specifies whether an external disk needs to be mounted.
                                     type: boolean
                                   required:
                                     description: Required disk space.
@@ -428,16 +371,13 @@ spec:
                                 - required
                                 type: object
                               mountPath:
-                                description: MountPath at which this volume will be
-                                  mounted within its container.
+                                description: MountPath at which this volume will be mounted within its container.
                                 type: string
                               name:
-                                description: Name of this volume. Must be unique within
-                                  its container.
+                                description: Name of this volume. Must be unique within its container.
                                 type: string
                               sharingPolicy:
-                                description: SharingPolicy of this volume; Exclusive
-                                  or Shared.
+                                description: SharingPolicy of this volume; Exclusive or Shared.
                                 enum:
                                 - Exclusive
                                 - Shared
@@ -466,8 +406,7 @@ spec:
             - containers
             type: object
           status:
-            description: A ContainerizedWorkloadStatus represents the observed state
-              of a ContainerizedWorkload.
+            description: A ContainerizedWorkloadStatus represents the observed state of a ContainerizedWorkload.
             properties:
               conditions:
                 description: Conditions of the resource.
@@ -475,25 +414,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime
@@ -505,9 +439,7 @@ spec:
               resources:
                 description: Resources managed by this containerised workload.
                 items:
-                  description: A TypedReference refers to an object by Name, Kind,
-                    and APIVersion. It is commonly used to reference cluster-scoped
-                    objects or objects where the namespace is already known.
+                  description: A TypedReference refers to an object by Name, Kind, and APIVersion. It is commonly used to reference cluster-scoped objects or objects where the namespace is already known.
                   properties:
                     apiVersion:
                       description: APIVersion of the referenced object.

charts/vela-core/crds/core.oam.dev_healthscopes.yaml

@@ -26,18 +26,13 @@ spec:
     name: v1alpha2
     schema:
       openAPIV3Schema:
-        description: A HealthScope determines an aggregate health status based of
-          the health of components.
+        description: A HealthScope determines an aggregate health status based of the health of components.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -45,22 +40,17 @@ spec:
             description: A HealthScopeSpec defines the desired state of a HealthScope.
             properties:
               probe-interval:
-                description: ProbeInterval is the amount of time in seconds between
-                  probing tries.
+                description: ProbeInterval is the amount of time in seconds between probing tries.
                 format: int32
                 type: integer
               probe-timeout:
-                description: ProbeTimeout is the amount of time in seconds to wait
-                  when receiving a response before marked failure.
+                description: ProbeTimeout is the amount of time in seconds to wait when receiving a response before marked failure.
                 format: int32
                 type: integer
               workloadRefs:
-                description: WorkloadReferences to the workloads that are in this
-                  scope.
+                description: WorkloadReferences to the workloads that are in this scope.
                 items:
-                  description: A TypedReference refers to an object by Name, Kind,
-                    and APIVersion. It is commonly used to reference cluster-scoped
-                    objects or objects where the namespace is already known.
+                  description: A TypedReference refers to an object by Name, Kind, and APIVersion. It is commonly used to reference cluster-scoped objects or objects where the namespace is already known.
                   properties:
                     apiVersion:
                       description: APIVersion of the referenced object.
@@ -92,25 +82,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime
@@ -120,15 +105,12 @@ spec:
                   type: object
                 type: array
               healthConditions:
-                description: WorkloadHealthConditions represents health condition
-                  of workloads in the scope
+                description: WorkloadHealthConditions represents health condition of workloads in the scope
                 items:
-                  description: WorkloadHealthCondition represents informative health
-                    condition.
+                  description: WorkloadHealthCondition represents informative health condition.
                   properties:
                     componentName:
-                      description: ComponentName represents the component name if
-                        target is a workload
+                      description: ComponentName represents the component name if target is a workload
                       type: string
                     diagnosis:
                       type: string
@@ -136,9 +118,7 @@ spec:
                       description: HealthStatus represents health status strings.
                       type: string
                     targetWorkload:
-                      description: A TypedReference refers to an object by Name, Kind,
-                        and APIVersion. It is commonly used to reference cluster-scoped
-                        objects or objects where the namespace is already known.
+                      description: A TypedReference refers to an object by Name, Kind, and APIVersion. It is commonly used to reference cluster-scoped objects or objects where the namespace is already known.
                       properties:
                         apiVersion:
                           description: APIVersion of the referenced object.
@@ -158,16 +138,14 @@ spec:
                       - name
                       type: object
                     workloadStatus:
-                      description: WorkloadStatus represents status of workloads whose
-                        HealthStatus is UNKNOWN.
+                      description: WorkloadStatus represents status of workloads whose HealthStatus is UNKNOWN.
                       type: string
                   required:
                   - healthStatus
                   type: object
                 type: array
               scopeHealthCondition:
-                description: ScopeHealthCondition represents health condition summary
-                  of the scope
+                description: ScopeHealthCondition represents health condition summary of the scope
                 properties:
                   healthStatus:
                     description: HealthStatus represents health status strings.

charts/vela-core/crds/core.oam.dev_manualscalertraits.yaml

@@ -22,18 +22,13 @@ spec:
   - name: v1alpha2
     schema:
       openAPIV3Schema:
-        description: A ManualScalerTrait determines how many replicas a workload should
-          have.
+        description: A ManualScalerTrait determines how many replicas a workload should have.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -45,8 +40,7 @@ spec:
                 format: int32
                 type: integer
               workloadRef:
-                description: WorkloadReference to the workload this trait applies
-                  to.
+                description: WorkloadReference to the workload this trait applies to.
                 properties:
                   apiVersion:
                     description: APIVersion of the referenced object.
@@ -70,8 +64,7 @@ spec:
             - workloadRef
             type: object
           status:
-            description: A ManualScalerTraitStatus represents the observed state of
-              a ManualScalerTrait.
+            description: A ManualScalerTraitStatus represents the observed state of a ManualScalerTrait.
             properties:
               conditions:
                 description: Conditions of the resource.
@@ -79,25 +72,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime

charts/vela-core/crds/core.oam.dev_scopedefinitions.yaml

@@ -26,20 +26,13 @@ spec:
     name: v1alpha2
     schema:
       openAPIV3Schema:
-        description: A ScopeDefinition registers a kind of Kubernetes custom resource
-          as a valid OAM scope kind by referencing its CustomResourceDefinition. The
-          CRD is used to validate the schema of the scope when it is embedded in an
-          OAM ApplicationConfiguration.
+        description: A ScopeDefinition registers a kind of Kubernetes custom resource as a valid OAM scope kind by referencing its CustomResourceDefinition. The CRD is used to validate the schema of the scope when it is embedded in an OAM ApplicationConfiguration.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -47,27 +40,26 @@ spec:
             description: A ScopeDefinitionSpec defines the desired state of a ScopeDefinition.
             properties:
               allowComponentOverlap:
-                description: AllowComponentOverlap specifies whether an OAM component
-                  may exist in multiple instances of this kind of scope.
+                description: AllowComponentOverlap specifies whether an OAM component may exist in multiple instances of this kind of scope.
                 type: boolean
               definitionRef:
-                description: Reference to the CustomResourceDefinition that defines
-                  this scope kind.
+                description: Reference to the CustomResourceDefinition that defines this scope kind.
                 properties:
                   name:
                     description: Name of the referenced CustomResourceDefinition.
                     type: string
+                  version:
+                    description: Version indicate which version should be used if CRD has multiple versions by default it will use the first one if not specified
+                    type: string
                 required:
                 - name
                 type: object
               extension:
-                description: Extension is used for extension needs by OAM platform
-                  builders
+                description: Extension is used for extension needs by OAM platform builders
                 type: object
                 x-kubernetes-preserve-unknown-fields: true
               workloadRefsPath:
-                description: WorkloadRefsPath indicates if/where a scope accepts workloadRef
-                  objects
+                description: WorkloadRefsPath indicates if/where a scope accepts workloadRef objects
                 type: string
             required:
             - allowComponentOverlap

charts/vela-core/crds/core.oam.dev_traitdefinitions.yaml

@@ -26,20 +26,13 @@ spec:
     name: v1alpha2
     schema:
       openAPIV3Schema:
-        description: A TraitDefinition registers a kind of Kubernetes custom resource
-          as a valid OAM trait kind by referencing its CustomResourceDefinition. The
-          CRD is used to validate the schema of the trait when it is embedded in an
-          OAM ApplicationConfiguration.
+        description: A TraitDefinition registers a kind of Kubernetes custom resource as a valid OAM trait kind by referencing its CustomResourceDefinition. The CRD is used to validate the schema of the trait when it is embedded in an OAM ApplicationConfiguration.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -47,35 +40,31 @@ spec:
             description: A TraitDefinitionSpec defines the desired state of a TraitDefinition.
             properties:
               appliesToWorkloads:
-                description: AppliesToWorkloads specifies the list of workload kinds
-                  this trait applies to. Workload kinds are specified in kind.group/version
-                  format, e.g. server.core.oam.dev/v1alpha2. Traits that omit this
-                  field apply to all workload kinds.
+                description: AppliesToWorkloads specifies the list of workload kinds this trait applies to. Workload kinds are specified in kind.group/version format, e.g. server.core.oam.dev/v1alpha2. Traits that omit this field apply to all workload kinds.
                 items:
                   type: string
                 type: array
               definitionRef:
-                description: Reference to the CustomResourceDefinition that defines
-                  this trait kind.
+                description: Reference to the CustomResourceDefinition that defines this trait kind.
                 properties:
                   name:
                     description: Name of the referenced CustomResourceDefinition.
                     type: string
+                  version:
+                    description: Version indicate which version should be used if CRD has multiple versions by default it will use the first one if not specified
+                    type: string
                 required:
                 - name
                 type: object
               extension:
-                description: Extension is used for extension needs by OAM platform
-                  builders
+                description: Extension is used for extension needs by OAM platform builders
                 type: object
                 x-kubernetes-preserve-unknown-fields: true
               revisionEnabled:
-                description: Revision indicates whether a trait is aware of component
-                  revision
+                description: Revision indicates whether a trait is aware of component revision
                 type: boolean
               workloadRefPath:
-                description: WorkloadRefPath indicates where/if a trait accepts a
-                  workloadRef object
+                description: WorkloadRefPath indicates where/if a trait accepts a workloadRef object
                 type: string
             required:
             - definitionRef

charts/vela-core/crds/core.oam.dev_workloaddefinitions.yaml

@@ -26,20 +26,13 @@ spec:
     name: v1alpha2
     schema:
       openAPIV3Schema:
-        description: A WorkloadDefinition registers a kind of Kubernetes custom resource
-          as a valid OAM workload kind by referencing its CustomResourceDefinition.
-          The CRD is used to validate the schema of the workload when it is embedded
-          in an OAM Component.
+        description: A WorkloadDefinition registers a kind of Kubernetes custom resource as a valid OAM workload kind by referencing its CustomResourceDefinition. The CRD is used to validate the schema of the workload when it is embedded in an OAM Component.
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -47,11 +40,9 @@ spec:
             description: A WorkloadDefinitionSpec defines the desired state of a WorkloadDefinition.
             properties:
               childResourceKinds:
-                description: ChildResourceKinds are the list of GVK of the child resources
-                  this workload generates
+                description: ChildResourceKinds are the list of GVK of the child resources this workload generates
                 items:
-                  description: A ChildResourceKind defines a child Kubernetes resource
-                    kind with a selector
+                  description: A ChildResourceKind defines a child Kubernetes resource kind with a selector
                   properties:
                     apiVersion:
                       description: APIVersion of the child resource
@@ -62,8 +53,7 @@ spec:
                     selector:
                       additionalProperties:
                         type: string
-                      description: Selector to select the child resources that the
-                        workload wants to expose to traits
+                      description: Selector to select the child resources that the workload wants to expose to traits
                       type: object
                   required:
                   - apiVersion
@@ -71,29 +61,26 @@ spec:
                   type: object
                 type: array
               definitionRef:
-                description: Reference to the CustomResourceDefinition that defines
-                  this workload kind.
+                description: Reference to the CustomResourceDefinition that defines this workload kind.
                 properties:
                   name:
                     description: Name of the referenced CustomResourceDefinition.
                     type: string
+                  version:
+                    description: Version indicate which version should be used if CRD has multiple versions by default it will use the first one if not specified
+                    type: string
                 required:
                 - name
                 type: object
               extension:
-                description: Extension is used for extension needs by OAM platform
-                  builders
+                description: Extension is used for extension needs by OAM platform builders
                 type: object
                 x-kubernetes-preserve-unknown-fields: true
               podSpecPath:
-                description: PodSpecPath indicates where/if this workload has K8s
-                  podSpec field if one workload has podSpec, trait can do lot's of
-                  assumption such as port, env, volume fields.
+                description: PodSpecPath indicates where/if this workload has K8s podSpec field if one workload has podSpec, trait can do lot's of assumption such as port, env, volume fields.
                 type: string
               revisionLabel:
-                description: RevisionLabel indicates which label for underlying resources(e.g.
-                  pods) of this workload can be used by trait to create resource selectors(e.g.
-                  label selector for pods).
+                description: RevisionLabel indicates which label for underlying resources(e.g. pods) of this workload can be used by trait to create resource selectors(e.g. label selector for pods).
                 type: string
             required:
             - definitionRef

charts/vela-core/crds/standard.oam.dev_autoscalers.yaml

@@ -4,7 +4,7 @@ apiVersion: apiextensions.k8s.io/v1
 kind: CustomResourceDefinition
 metadata:
   annotations:
-    controller-gen.kubebuilder.io/version: v0.2.5
+    controller-gen.kubebuilder.io/version: v0.2.4
   creationTimestamp: null
   name: autoscalers.standard.oam.dev
 spec:
@@ -24,14 +24,10 @@ spec:
         description: Autoscaler is the Schema for the autoscalers API
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -47,9 +43,7 @@ spec:
                 format: int32
                 type: integer
               targetWorkload:
-                description: TargetWorkload specify the workload which is going to
-                  be scaled, it could be WorkloadReference or the child resource of
-                  it
+                description: TargetWorkload specify the workload which is going to be scaled, it could be WorkloadReference or the child resource of it
                 properties:
                   apiVersion:
                     type: string
@@ -71,8 +65,7 @@ spec:
                       description: Condition set the condition when to trigger scaling
                       type: object
                     name:
-                      description: Name is the trigger name, if not set, it will be
-                        automatically generated and make it globally unique
+                      description: Name is the trigger name, if not set, it will be automatically generated and make it globally unique
                       type: string
                     type:
                       description: Type allows value in [cpu/memory/storage/ephemeral-storage、cron、pps、qps/rps、custom]
@@ -114,25 +107,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime

charts/vela-core/crds/standard.oam.dev_metricstraits.yaml

@@ -4,7 +4,7 @@ apiVersion: apiextensions.k8s.io/v1
 kind: CustomResourceDefinition
 metadata:
   annotations:
-    controller-gen.kubebuilder.io/version: v0.2.5
+    controller-gen.kubebuilder.io/version: v0.2.4
   creationTimestamp: null
   name: metricstraits.standard.oam.dev
 spec:
@@ -24,14 +24,10 @@ spec:
         description: MetricsTrait is the Schema for the metricstraits API
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -45,8 +41,7 @@ spec:
                     description: The default is true
                     type: boolean
                   format:
-                    description: The format of the metrics data, The default and only
-                      supported format is "prometheus" for now
+                    description: The format of the metrics data, The default and only supported format is "prometheus" for now
                     type: string
                   path:
                     description: HTTP path to scrape for metrics. default is /metrics
@@ -55,27 +50,19 @@ spec:
                     anyOf:
                     - type: integer
                     - type: string
-                    description: Number or name of the port to access on the pods
-                      targeted by the service. The default is discovered automatically
-                      from podTemplate, metricTrait will create a service for the
-                      workload
+                    description: Number or name of the port to access on the pods targeted by the service. The default is discovered automatically from podTemplate, metricTrait will create a service for the workload
                     x-kubernetes-int-or-string: true
                   scheme:
-                    description: Scheme at which metrics should be scraped The default
-                      and only supported scheme is "http"
+                    description: Scheme at which metrics should be scraped The default and only supported scheme is "http"
                     type: string
                   selector:
                     additionalProperties:
                       type: string
-                    description: Route service traffic to pods with label keys and
-                      values matching this The default is discovered automatically
-                      from podTemplate. If no podTemplate, use the labels specified
-                      here, or use the labels of the workload
+                    description: Route service traffic to pods with label keys and values matching this The default is discovered automatically from podTemplate. If no podTemplate, use the labels specified here, or use the labels of the workload
                     type: object
                 type: object
               workloadRef:
-                description: WorkloadReference to the workload whose metrics needs
-                  to be exposed
+                description: WorkloadReference to the workload whose metrics needs to be exposed
                 properties:
                   apiVersion:
                     description: APIVersion of the referenced object.
@@ -106,25 +93,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime

charts/vela-core/crds/standard.oam.dev_routes.yaml

@@ -4,7 +4,7 @@ apiVersion: apiextensions.k8s.io/v1
 kind: CustomResourceDefinition
 metadata:
   annotations:
-    controller-gen.kubebuilder.io/version: v0.2.5
+    controller-gen.kubebuilder.io/version: v0.2.4
   creationTimestamp: null
   name: routes.standard.oam.dev
 spec:
@@ -24,14 +24,10 @@ spec:
         description: Route is the Schema for the routes API
         properties:
           apiVersion:
-            description: 'APIVersion defines the versioned schema of this representation
-              of an object. Servers should convert recognized schemas to the latest
-              internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
+            description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
             type: string
           kind:
-            description: 'Kind is a string value representing the REST resource this
-              object represents. Servers may infer this from the endpoint the client
-              submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
+            description: 'Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
             type: string
           metadata:
             type: object
@@ -42,8 +38,7 @@ spec:
                 description: Host is the host of the route
                 type: string
               provider:
-                description: Provider indicate which ingress controller implementation
-                  the route trait will use, by default it's nginx-ingress
+                description: Provider indicate which ingress controller implementation the route trait will use, by default it's nginx-ingress
                 type: string
               rules:
                 description: Rules contain multiple rules of route
@@ -51,46 +46,38 @@ spec:
                   description: Rule defines to route rule
                   properties:
                     backend:
-                      description: Backend indicate how to connect backend service
-                        If it's nil, will auto discovery
+                      description: Backend indicate how to connect backend service If it's nil, will auto discovery
                       properties:
                         backendService:
-                          description: BackendService specifies the backend K8s service
-                            and port, it's optional
+                          description: BackendService specifies the backend K8s service and port, it's optional
                           properties:
                             port:
                               anyOf:
                               - type: integer
                               - type: string
-                              description: Port allow you direct specify backend service
-                                port.
+                              description: Port allow you direct specify backend service port.
                               x-kubernetes-int-or-string: true
                             serviceName:
-                              description: ServiceName allow you direct specify K8s
-                                service for backend service.
+                              description: ServiceName allow you direct specify K8s service for backend service.
                               type: string
                           required:
                           - port
                           - serviceName
                           type: object
                         readTimeout:
-                          description: ReadTimeout used for setting read timeout duration
-                            for backend service, the unit is second.
+                          description: ReadTimeout used for setting read timeout duration for backend service, the unit is second.
                           type: integer
                         sendTimeout:
-                          description: SendTimeout used for setting send timeout duration
-                            for backend service, the unit is second.
+                          description: SendTimeout used for setting send timeout duration for backend service, the unit is second.
                           type: integer
                       type: object
                     customHeaders:
                       additionalProperties:
                         type: string
-                      description: CustomHeaders pass a custom list of headers to
-                        the backend service.
+                      description: CustomHeaders pass a custom list of headers to the backend service.
                       type: object
                     defaultBackend:
-                      description: DefaultBackend will become the ingress default
-                        backend if the backend is not available
+                      description: DefaultBackend will become the ingress default backend if the backend is not available
                       properties:
                         apiVersion:
                           description: APIVersion of the referenced object.
@@ -110,34 +97,28 @@ spec:
                       - name
                       type: object
                     name:
-                      description: Name will become the suffix of underlying ingress
-                        created by this rule, if not, will use index as suffix.
+                      description: Name will become the suffix of underlying ingress created by this rule, if not, will use index as suffix.
                       type: string
                     path:
                       description: Path is location Path, default for "/"
                       type: string
                     rewriteTarget:
-                      description: RewriteTarget will rewrite request from Path to
-                        RewriteTarget path.
+                      description: RewriteTarget will rewrite request from Path to RewriteTarget path.
                       type: string
                   type: object
                 type: array
               tls:
-                description: TLS indicate route trait will create SSL secret using
-                  cert-manager with specified issuer If this is nil, route trait will
-                  use a selfsigned issuer
+                description: TLS indicate route trait will create SSL secret using cert-manager with specified issuer If this is nil, route trait will use a selfsigned issuer
                 properties:
                   issuerName:
                     type: string
                   type:
                     default: Issuer
-                    description: Type indicate the issuer is ClusterIssuer or Issuer(namespace
-                      issuer), by default, it's Issuer
+                    description: Type indicate the issuer is ClusterIssuer or Issuer(namespace issuer), by default, it's Issuer
                     type: string
                 type: object
               workloadRef:
-                description: WorkloadReference to the workload whose metrics needs
-                  to be exposed
+                description: WorkloadReference to the workload whose metrics needs to be exposed
                 properties:
                   apiVersion:
                     description: APIVersion of the referenced object.
@@ -168,25 +149,20 @@ spec:
                   description: A Condition that may apply to a resource.
                   properties:
                     lastTransitionTime:
-                      description: LastTransitionTime is the last time this condition
-                        transitioned from one status to another.
+                      description: LastTransitionTime is the last time this condition transitioned from one status to another.
                       format: date-time
                       type: string
                     message:
-                      description: A Message containing details about this condition's
-                        last transition from one status to another, if any.
+                      description: A Message containing details about this condition's last transition from one status to another, if any.
                       type: string
                     reason:
-                      description: A Reason for this condition's last transition from
-                        one status to another.
+                      description: A Reason for this condition's last transition from one status to another.
                       type: string
                     status:
-                      description: Status of this condition; is it currently True,
-                        False, or Unknown?
+                      description: Status of this condition; is it currently True, False, or Unknown?
                       type: string
                     type:
-                      description: Type of this condition. At most one of each condition
-                        type may apply to a resource at any point in time.
+                      description: Type of this condition. At most one of each condition type may apply to a resource at any point in time.
                       type: string
                   required:
                   - lastTransitionTime
@@ -197,9 +173,7 @@ spec:
                 type: array
               ingresses:
                 items:
-                  description: A TypedReference refers to an object by Name, Kind,
-                    and APIVersion. It is commonly used to reference cluster-scoped
-                    objects or objects where the namespace is already known.
+                  description: A TypedReference refers to an object by Name, Kind, and APIVersion. It is commonly used to reference cluster-scoped objects or objects where the namespace is already known.
                   properties:
                     apiVersion:
                       description: APIVersion of the referenced object.
@@ -220,9 +194,7 @@ spec:
                   type: object
                 type: array
               service:
-                description: A TypedReference refers to an object by Name, Kind, and
-                  APIVersion. It is commonly used to reference cluster-scoped objects
-                  or objects where the namespace is already known.
+                description: A TypedReference refers to an object by Name, Kind, and APIVersion. It is commonly used to reference cluster-scoped objects or objects where the namespace is already known.
                 properties:
                   apiVersion:
                     description: APIVersion of the referenced object.

charts/vela-core/templates/definitions/healthscopes.yaml

@@ -2,9 +2,6 @@ apiVersion: core.oam.dev/v1alpha2
 kind: ScopeDefinition
 metadata:
   name: healthscopes.core.oam.dev
-  annotations:
-    definition.oam.dev/apiVersion: core.oam.dev/v1alpha2
-    definition.oam.dev/kind: HealthScope
   namespace: default
 spec:
   workloadRefsPath: spec.workloadRefs

charts/vela-core/templates/defwithtemplate/autoscale.yaml

@@ -3,33 +3,31 @@ kind: TraitDefinition
 metadata:
   name: autoscale
   annotations:
-    definition.oam.dev/apiVersion: standard.oam.dev/v1alpha1
-    definition.oam.dev/kind: Autoscaler
-    definition.oam.dev/description: "Automatically scale workloads"
+    definition.oam.dev/description: "`Autoscale` is used to automatically scale workloads by resource utilization metrics or cron triggers."
 spec:
   appliesToWorkloads:
     - webservice
-    - backend
-    - deployments.apps
-    - podspecworkload
+    - worker
   workloadRefPath: spec.workloadRef
   definitionRef:
     name: autoscalers.standard.oam.dev
   extension:
     template: |
+      import "strconv"
+      
       output: {
       	apiVersion: "standard.oam.dev/v1alpha1"
       	kind:       "Autoscaler"
       	spec: {
       		minReplicas: parameter.min
       		maxReplicas: parameter.max
-      		if parameter["cpu"] != _|_ && parameter["cron"] != _|_ {
+      		if parameter["cpuPercent"] != _|_ && parameter["cron"] != _|_ {
       			triggers: [cpuScaler, cronScaler]
       		}
-      		if parameter["cpu"] != _|_ && parameter["cron"] == _|_ {
+      		if parameter["cpuPercent"] != _|_ && parameter["cron"] == _|_ {
       			triggers: [cpuScaler]
       		}
-      		if parameter["cpu"] == _|_ && parameter["cron"] != _|_ {
+      		if parameter["cpuPercent"] == _|_ && parameter["cron"] != _|_ {
       			triggers: [cronScaler]
       		}
       	}
@@ -39,34 +37,45 @@ spec:
       	type: "cpu"
       	condition: {
       		type: "Utilization"
-      		if parameter["cpu"] != _|_ {
-      			value: parameter.cpu
+      		if parameter["cpuPercent"] != _|_ {
+      			// Temporarily use `strconv` for type converting. This bug will be fixed in kubevela#585
+      			value: strconv.FormatInt(parameter.cpuPercent, 10)
       		}
       	}
       }
       
       cronScaler: {
       	type: "cron"
-      	if parameter["cron"] != _|_ {
-      		condition: parameter.cron
+      	if parameter["cron"] != _|_ && parameter.cron["replicas"] != _|_ {
+      		condition: {
+      			startAt:  parameter.cron.startAt
+      			duration: parameter.cron.duration
+      			days:     parameter.cron.days
+      			replicas: strconv.FormatInt(parameter.cron.replicas, 10)
+      			timezone: parameter.cron.timezone
+      		}
       	}
       }
       
       parameter: {
-      	// +usage=minimal replicas of the workload
+      	// +usage=Minimal replicas of the workload
       	min: int
-      	// +usage=maximal replicas of the workload
+      	// +usage=Maximal replicas of the workload
       	max: int
-      	// +usage=specify the value for CPU utilization, like 80, which means 80%
-      	cpu?: string
-      	// +usage=just for `appfile`, not available for Cli usage
+      	// +usage=Specify the value for CPU utilization, like 80, which means 80%
+      	// +alias=cpu-percent
+      	cpuPercent?: int
+      	// +usage=Cron type auto-scaling. Just for `appfile`, not available for Cli usage
       	cron?: {
-      		startAt:  string
+      		// +usage=The time to start scaling, like `08:00`
+      		startAt: string
+      		// +usage=For how long the scaling will last
       		duration: string
-      		// +usage=several workdays or weekends, like "Monday, Tuesday"
-      		days:     string
-      		replicas: string
-      		// +usage=timezone, like "America/Seattle"
+      		// +usage=Several workdays or weekends, like "Monday, Tuesday"
+      		days: string
+      		// +usage=The target replicas to be scaled to
+      		replicas: int
+      		// +usage=Timezone, like "America/Los_Angeles"
       		timezone: string
       	}
       }

charts/vela-core/templates/defwithtemplate/manualscale.yaml

@@ -2,15 +2,12 @@ apiVersion: core.oam.dev/v1alpha2
 kind: TraitDefinition
 metadata:
   annotations:
-    definition.oam.dev/apiVersion: core.oam.dev/v1alpha2
-    definition.oam.dev/kind: ManualScalerTrait
-    definition.oam.dev/description: "Scale replica for workload"
+    definition.oam.dev/description: "`Scaler` is used to configure replicas for your service."
   name: scaler
 spec:
   appliesToWorkloads:
     - webservice
-    - containerizedworkloads.core.oam.dev
-    - deployments.apps
+    - worker
   definitionRef:
     name: manualscalertraits.core.oam.dev
   workloadRefPath: spec.workloadRef
@@ -20,11 +17,12 @@ spec:
       	apiVersion: "core.oam.dev/v1alpha2"
       	kind:       "ManualScalerTrait"
       	spec: {
-      		replicaCount: parameter.replica
+      		replicaCount: parameter.replicas
       	}
       }
       parameter: {
       	//+short=r
-      	replica: *1 | int
+      	//+usage=Replicas of the workload
+      	replicas: *1 | int
       }
       

charts/vela-core/templates/defwithtemplate/metrics.yaml

@@ -1,20 +1,14 @@
 apiVersion: core.oam.dev/v1alpha2
 kind: TraitDefinition
 metadata:
-  name: metric
+  name: metrics
   annotations:
-    definition.oam.dev/apiVersion: standard.oam.dev/v1alpha1
-    definition.oam.dev/kind: MetricsTrait
-    definition.oam.dev/description: "Add metric monitoring for workload"
+    definition.oam.dev/description: "`Metrics` is used to configure monitoring metrics for your service."
 spec:
   appliesToWorkloads:
     - webservice
     - backend
     - task
-    - containerizedworkloads.core.oam.dev
-    - clonesetworkloads.apps.kruise.io
-    - deployments.apps
-    - statefulsets.apps
   definitionRef:
     name: metricstraits.standard.oam.dev
   workloadRefPath: spec.workloadRef
@@ -28,16 +22,17 @@ spec:
       	}
       }
       parameter: {
-      	// +usage=format of the metrics, default as prometheus
+      	// +usage=Format of the metrics, default as prometheus
       	// +short=f
       	format: *"prometheus" | string
-      	// +usage= the metric path of the service
-      	path:    *"/metrics" | string
+      	// +usage=The metrics path of the service
+      	path: *"/metrics" | string
+      	// +usage=The way to retrieve data which can take the values `http` or `https`
       	scheme:  *"http" | string
       	enabled: *true | bool
-      	// +usage= the port for metrics, will discovery automatically by default
+      	// +usage=The port for metrics, will discovery automatically by default
       	port: *0 | >=1024 & <=65535 & int
-      	// +usage= the label selector for the pods, will discovery automatically by default
+      	// +usage=The label selector for the pods, will discovery automatically by default
       	selector?: [string]: string
       }
       

charts/vela-core/templates/defwithtemplate/rollout.yaml

@@ -2,10 +2,11 @@ apiVersion: core.oam.dev/v1alpha2
 kind: TraitDefinition
 metadata:
   name: rollout
+  annotations:
+    definition.oam.dev/description: "`Rollout` is used to configure Canary deployment strategy for your application."
 spec:
   appliesToWorkloads:
-    - podspecworkload.standard.oam.dev
-    - deployments.apps
+    - webservice
   definitionRef:
     name: canaries.flagger.app
   workloadRefPath: spec.targetRef
@@ -35,16 +36,17 @@ spec:
       			// percentage (0-100)
       			stepWeight: parameter.stepWeight
       			// max replicas scale up to canary
-      			maxReplicas: parameter.replica
+      			maxReplicas: parameter.replicas
       		}
       	}
       }
       parameter: {
-      	// +usage=total replica of the workload
-      	replica: *5 | int
+      	// +usage=Total replicas of the workload
+      	replicas: *2 | int
       	// +alias=step-weight
-      	// +usage=weight percent of every step in rolling update
-      	stepWeight: *20 | int
-      	interval:   *"30s" | string
+      	// +usage=Weight percent of every step in rolling update
+      	stepWeight: *50 | int
+      	// +usage=Schedule interval time
+      	interval: *"30s" | string
       }
       

charts/vela-core/templates/defwithtemplate/route.yaml

@@ -3,13 +3,10 @@ kind: TraitDefinition
 metadata:
   name: route
   annotations:
-    definition.oam.dev/apiVersion: standard.oam.dev/v1alpha1
-    definition.oam.dev/kind: Route
-    definition.oam.dev/description: "Add a route for workload"
+    definition.oam.dev/description: "`Route` is used to configure external access to your service."
 spec:
   appliesToWorkloads:
     - webservice
-    - deployments.apps
   workloadRefPath: spec.workloadRef
   definitionRef:
     name: routes.standard.oam.dev
@@ -33,7 +30,9 @@ spec:
       	}
       }
       parameter: {
+      	// +usage= Domain name
       	domain: *"" | string
+      
       	issuer: *"" | string
       	rules?: [...{
       		path:          string

charts/vela-core/templates/defwithtemplate/task.yaml

@@ -3,16 +3,14 @@ kind: WorkloadDefinition
 metadata:
   name: task
   annotations:
-    definition.oam.dev/apiVersion: "v1"
-    definition.oam.dev/kind: "Job"
-    definition.oam.dev/description: "One-time task/job"
+    definition.oam.dev/description: "`Task` is a workload type to describe jobs that run code or a script to completion."
 spec:
   definitionRef:
-    name: jobs
+    name: jobs.batch
   extension:
     template: |
       output: {
-      	apiVersion: "v1"
+      	apiVersion: "batch/v1"
       	kind:       "Job"
       	spec: {
       		parallelism: parameter.count
@@ -34,10 +32,11 @@ spec:
       	// +short=c
       	count: *1 | int
       
-      	// +usage=specify app image
+      	// +usage=Which image would you like to use for your service
       	// +short=i
       	image: string
       
+      	// +usage=Commands to run in the container
       	cmd?: [...string]
       }
       

charts/vela-core/templates/defwithtemplate/webservice.yaml

@@ -3,9 +3,8 @@ kind: WorkloadDefinition
 metadata:
   name: webservice
   annotations:
-    definition.oam.dev/apiVersion: "apps/v1"
-    definition.oam.dev/kind: "Deployment"
-    definition.oam.dev/description: "Long running service with network routes"
+    definition.oam.dev/description: "`Webservice` is a workload type to describe long-running, scalable, containerized services that have a stable network endpoint to receive external network traffic from customers.
+    If workload type is skipped for any service defined in Appfile, it will be defaulted to `Web Service` type."
 spec:
   definitionRef:
     name: deployments.apps
@@ -38,24 +37,19 @@ spec:
       					}
       
       					if context["config"] != _|_ {
-      						env: [
-      							for k, v in context.config {
-      								name:  k
-      								value: v
-      							},
-      						]
+      						env: context.config
       					}
       
       					ports: [{
       						containerPort: parameter.port
       					}]
       
-      					if parameter["cpuRequests"] != _|_ {
+      					if parameter["cpu"] != _|_ {
       						resources: {
       							limits:
-      								cpu: parameter.cpuRequests
+      								cpu: parameter.cpu
       							requests:
-      								cpu: parameter.cpuRequests
+      								cpu: parameter.cpu
       						}
       					}
       				}]
@@ -64,28 +58,34 @@ spec:
       	}
       }
       parameter: {
-      	// +usage=specify app image
+      	// +usage=Which image would you like to use for your service
       	// +short=i
       	image: string
       
+      	// +usage=Commands to run in the container
       	cmd?: [...string]
       
-      	// +usage=specify port for container
+      	// +usage=Which port do you want customer traffic sent to
       	// +short=p
-      	port: *6379 | int
-      
+      	port: *80 | int
+      	// +usage=Define arguments by using environment variables
       	env?: [...{
-      		name:   string
+      		// +usage=Environment variable name
+      		name: string
+      		// +usage=The value of the environment variable
       		value?: string
+      		// +usage=Specifies a source the value of this var should come from
       		valueFrom?: {
+      			// +usage=Selects a key of a secret in the pod's namespace
       			secretKeyRef: {
+      				// +usage=The name of the secret in the pod's namespace to select from
       				name: string
-      				key:  string
+      				// +usage=The key of the secret to select from. Must be a valid secret key
+      				key: string
       			}
       		}
       	}]
-      	// +usage=CPU core requests for the workload
-      	// +alias=cpu-requests
-      	cpuRequests?: string
+      	// +usage=Number of CPU units for the service, like `0.5` (0.5 CPU core), `1` (1 CPU core)
+      	cpu?: string
       }
       

charts/vela-core/templates/defwithtemplate/worker.yaml

@@ -3,9 +3,7 @@ kind: WorkloadDefinition
 metadata:
   name: worker
   annotations:
-    definition.oam.dev/apiVersion: "apps/v1"
-    definition.oam.dev/kind: "Deployment"
-    definition.oam.dev/description: "Backend worker without ports exposed"
+    definition.oam.dev/description: "`Worker` is a workload type to describe long-running, scalable, containerized services that running at backend. They do NOT have network endpoint to receive external network traffic."
 spec:
   definitionRef:
     name: deployments.apps
@@ -43,10 +41,10 @@ spec:
       }
       
       parameter: {
-      	// +usage=specify app image
+      	// +usage=Which image would you like to use for your service
       	// +short=i
       	image: string
-      
+      	// +usage=Commands to run in the container
       	cmd?: [...string]
       }
       

charts/vela-core/templates/kubevela-controller.yaml

@@ -111,8 +111,11 @@ spec:
             - "--use-webhook=true"
             - "--webhook-port={{ .Values.webhookService.port }}"
             - "--webhook-cert-dir={{ .Values.certificate.mountPath }}"
+            {{ end }}
             - "--health-addr=:{{ .Values.healthCheck.port }}"
-          {{ end }}
+            {{ if ne .Values.disableCaps "" }}
+            - "--disable-caps={{ .Values.disableCaps }}"
+            {{ end }}
           image: {{ .Values.image.repository }}:{{ .Values.image.tag }}
           imagePullPolicy: {{ quote .Values.image.pullPolicy }}
           resources:

charts/vela-core/templates/velaConfig.yaml

@@ -2,7 +2,8 @@ apiVersion: v1
 kind: ConfigMap
 metadata:
   name: vela-config
-  namespace: {{ .Release.Namespace }}
+  # TODO: Currently namespace MUST be vela-system
+  namespace: vela-system
 data:
   servicemonitors.monitoring.coreos.com: |
     {

charts/vela-core/values.yaml

@@ -4,6 +4,8 @@
 
 replicaCount: 1
 useWebhook: true
+# By default, don't disable any builtin capabilities
+disableCaps: ""
 image:
   repository: oamdev/vela-core
   tag: latest

cmd/core/main.go

@@ -12,12 +12,10 @@ import (
 	"syscall"
 	"time"
 
+	"github.com/oam-dev/kubevela/version"
+
 	monitoring "github.com/coreos/prometheus-operator/pkg/apis/monitoring/v1"
 	"github.com/crossplane/crossplane-runtime/pkg/logging"
-	oamcore "github.com/crossplane/oam-kubernetes-runtime/apis/core"
-	oamcontroller "github.com/crossplane/oam-kubernetes-runtime/pkg/controller"
-	oamv1alpha2 "github.com/crossplane/oam-kubernetes-runtime/pkg/controller/v1alpha2"
-	oamwebhook "github.com/crossplane/oam-kubernetes-runtime/pkg/webhook/v1alpha2"
 	"github.com/go-logr/logr"
 	injectorv1alpha1 "github.com/oam-dev/trait-injector/api/v1alpha1"
 	injectorcontroller "github.com/oam-dev/trait-injector/controllers"
@@ -35,11 +33,15 @@ import (
 	"sigs.k8s.io/controller-runtime/pkg/healthz"
 	"sigs.k8s.io/controller-runtime/pkg/log/zap"
 
-	velacoreoamdev "github.com/oam-dev/kubevela/api/core.oam.dev/v1alpha2"
-	velacore "github.com/oam-dev/kubevela/api/v1alpha1"
+	oamcore "github.com/oam-dev/kubevela/apis/core.oam.dev"
+	velacore "github.com/oam-dev/kubevela/apis/standard.oam.dev/v1alpha1"
 	velacontroller "github.com/oam-dev/kubevela/pkg/controller"
+	oamcontroller "github.com/oam-dev/kubevela/pkg/controller/core.oam.dev"
+	oamv1alpha2 "github.com/oam-dev/kubevela/pkg/controller/core.oam.dev/v1alpha2"
 	"github.com/oam-dev/kubevela/pkg/controller/dependency"
+	"github.com/oam-dev/kubevela/pkg/controller/utils"
 	velawebhook "github.com/oam-dev/kubevela/pkg/webhook"
+	oamwebhook "github.com/oam-dev/kubevela/pkg/webhook/core.oam.dev/v1alpha2"
 )
 
 const (
@@ -59,7 +61,6 @@ func init() {
 	_ = oamcore.AddToScheme(scheme)
 	_ = monitoring.AddToScheme(scheme)
 	_ = velacore.AddToScheme(scheme)
-	_ = velacoreoamdev.AddToScheme(scheme)
 	_ = injectorv1alpha1.AddToScheme(scheme)
 	_ = certmanager.AddToScheme(scheme)
 	_ = kedav1alpha1.AddToScheme(scheme)
@@ -67,7 +68,7 @@ func init() {
 }
 
 func main() {
-	var metricsAddr, logFilePath string
+	var metricsAddr, logFilePath, leaderElectionNamespace string
 	var enableLeaderElection, logCompress bool
 	var logRetainDate int
 	var certDir string
@@ -75,6 +76,7 @@ func main() {
 	var useWebhook, useTraitInjector bool
 	var controllerArgs oamcontroller.Args
 	var healthAddr string
+	var disableCaps string
 
 	flag.BoolVar(&useWebhook, "use-webhook", false, "Enable Admission Webhook")
 	flag.BoolVar(&useTraitInjector, "use-trait-injector", false, "Enable TraitInjector")
@@ -83,12 +85,17 @@ func main() {
 	flag.StringVar(&metricsAddr, "metrics-addr", ":8080", "The address the metric endpoint binds to.")
 	flag.BoolVar(&enableLeaderElection, "enable-leader-election", false,
 		"Enable leader election for controller manager. Enabling this will ensure there is only one active controller manager.")
-	flag.StringVar(&logFilePath, "log-file-path", "", "The address the metric endpoint binds to.")
+	flag.StringVar(&leaderElectionNamespace, "leader-election-namespace", "",
+		"Determines the namespace in which the leader election configmap will be created.")
+	flag.StringVar(&logFilePath, "log-file-path", "", "The file to write logs to.")
 	flag.IntVar(&logRetainDate, "log-retain-date", 7, "The number of days of logs history to retain.")
 	flag.BoolVar(&logCompress, "log-compress", true, "Enable compression on the rotated logs.")
 	flag.IntVar(&controllerArgs.RevisionLimit, "revision-limit", 50,
 		"RevisionLimit is the maximum number of revisions that will be maintained. The default value is 50.")
 	flag.StringVar(&healthAddr, "health-addr", ":9440", "The address the health endpoint binds to.")
+	flag.BoolVar(&controllerArgs.ApplyOnceOnly, "apply-once-only", false,
+		"For the purpose of some production environment that workload or trait should not be affected if no spec change")
+	flag.StringVar(&disableCaps, "disable-caps", "", "To be disabled builtin capability list.")
 	flag.Parse()
 
 	// setup logging
@@ -108,6 +115,9 @@ func main() {
 		o.DestWritter = w
 	}))
 
+	setupLog.Info(fmt.Sprintf("KubeVela Version: %s, GIT Revision: %s.", version.VelaVersion, version.GitRevision))
+	setupLog.Info(fmt.Sprintf("Disable Capabilities: %s.", disableCaps))
+
 	// install dependency charts first
 	k8sClient, err := client.New(ctrl.GetConfigOrDie(), client.Options{Scheme: scheme})
 	if err != nil {
@@ -117,13 +127,14 @@ func main() {
 	go dependency.Install(k8sClient)
 
 	mgr, err := ctrl.NewManager(ctrl.GetConfigOrDie(), ctrl.Options{
-		Scheme:                 scheme,
-		MetricsBindAddress:     metricsAddr,
-		LeaderElection:         enableLeaderElection,
-		LeaderElectionID:       kubevelaName,
-		Port:                   webhookPort,
-		CertDir:                certDir,
-		HealthProbeBindAddress: healthAddr,
+		Scheme:                  scheme,
+		MetricsBindAddress:      metricsAddr,
+		LeaderElection:          enableLeaderElection,
+		LeaderElectionNamespace: leaderElectionNamespace,
+		LeaderElectionID:        kubevelaName,
+		Port:                    webhookPort,
+		CertDir:                 certDir,
+		HealthProbeBindAddress:  healthAddr,
 	})
 	if err != nil {
 		setupLog.Error(err, "unable to create a controller manager")
@@ -135,13 +146,18 @@ func main() {
 		os.Exit(1)
 	}
 
+	if err := utils.CheckDisabledCapabilities(disableCaps); err != nil {
+		setupLog.Error(err, "unable to get enabled capabilities")
+		os.Exit(1)
+	}
+
 	if useWebhook {
 		setupLog.Info("vela webhook enabled, will serving at :" + strconv.Itoa(webhookPort))
 		if err = oamwebhook.Add(mgr); err != nil {
 			setupLog.Error(err, "unable to setup oam runtime webhook")
 			os.Exit(1)
 		}
-		velawebhook.Register(mgr)
+		velawebhook.Register(mgr, disableCaps)
 		if err := waitWebhookSecretVolume(certDir, waitSecretTimeout, waitSecretInterval); err != nil {
 			setupLog.Error(err, "unable to get webhook secret")
 			os.Exit(1)
@@ -153,7 +169,7 @@ func main() {
 		os.Exit(1)
 	}
 
-	if err = velacontroller.Setup(mgr); err != nil {
+	if err = velacontroller.Setup(mgr, disableCaps); err != nil {
 		setupLog.Error(err, "unable to setup the vela core controller")
 		os.Exit(1)
 	}
@@ -177,6 +193,10 @@ func main() {
 	}
 
 	setupLog.Info("starting the vela controller manager")
+
+	if controllerArgs.ApplyOnceOnly {
+		setupLog.Info("applyOnceOnly is enabled that means workload or trait only apply once if no spec change even they are changed by others")
+	}
 	if err := mgr.Start(makeSignalHandler(setupLog, k8sClient)); err != nil {
 		setupLog.Error(err, "problem running manager")
 		os.Exit(1)
@@ -209,14 +229,18 @@ func waitWebhookSecretVolume(certDir string, timeout, interval time.Duration) er
 			int64(time.Since(start).Seconds()), int64(timeout.Seconds())))
 		if _, err := os.Stat(certDir); !os.IsNotExist(err) {
 			ready := func() bool {
-				f, _ := os.Open(certDir)
+				f, err := os.Open(filepath.Clean(certDir))
+				if err != nil {
+					return false
+				}
+				// nolint
 				defer f.Close()
 				// check if dir is empty
-				if _, err := f.Readdir(1); err == io.EOF {
+				if _, err := f.Readdir(1); errors.Is(err, io.EOF) {
 					return false
 				}
 				// check if secret files are empty
-				err := filepath.Walk(certDir, func(path string, info os.FileInfo, err error) error {
+				err = filepath.Walk(certDir, func(path string, info os.FileInfo, err error) error {
 					// even Cert dir is created, cert files are still empty for a while
 					if info.Size() == 0 {
 						return errors.New("secret is not ready")
@@ -237,6 +261,7 @@ func waitWebhookSecretVolume(certDir string, timeout, interval time.Duration) er
 	}
 }
 
+//nolint:unparam
 func makeSignalHandler(log logr.Logger, kubecli client.Client) (stopCh <-chan struct{}) {
 	stop := make(chan struct{})
 	c := make(chan os.Signal, 2)

codecov.yml

@@ -1,3 +1,6 @@
 coverage:
   status:
+    project:
+      default:
+        threshold: 0.5%
     patch: off

config/samples/vela-server/README.md

@@ -0,0 +1,146 @@
+# Vela Server
+## example
+
+In this Demo, Application application-sample will be converted to appconfig and component
+
+The fields in the application spec come from the parametes defined in the definition template
+, so we must install Definition at first
+
+Step 1: Install Workload Definition & Trait Definition
+```
+kubectl apply -f template.yaml
+```
+Step 2: Create a sample application in the cluster
+```
+kubectl apply -f application-sample.yaml
+```
+Step 3: View the application status
+```
+kubectl get -f application-sample.yaml -oyaml
+
+// You can see the following
+apiVersion: core.oam.dev/v1alpha2
+kind: Application
+metadata:
+  annotations:
+    kubectl.kubernetes.io/last-applied-configuration: |
+      {"apiVersion":"core.oam.dev/v1alpha2","kind":"Application","metadata":{"annotations":{},"name":"application-sample","namespace":"oam-test"},"spec":{"template":"services:\n  myweb:\n    type: worker\n    image: \"busybox\"\n    cmd:\n    - sleep\n    - \"1000\"\n    scaler:\n      replicas: 10"}}
+  name: application-sample
+  namespace: oam-test
+spec:
+  services:
+    myweb:
+      cmd:
+      - sleep
+      - "1000"
+      image: busybox
+      scaler:
+        replicas: 10
+      type: worker
+status:
+  conditions:
+  - lastTransitionTime: "2020-12-02T12:12:52Z"
+    reason: Available
+    status: "True"
+    type: Parsed
+  - lastTransitionTime: "2020-12-02T12:12:52Z"
+    reason: Available
+    status: "True"
+    type: Built
+  - lastTransitionTime: "2020-12-02T12:12:52Z"
+    reason: Available
+    status: "True"
+    type: Applied
+  status: running
+
+```
+
+Step 4: View the oam CR generated by application
+
+```
+kubectl get appconfig/application-sample -oyaml
+
+// appconfig is as follows
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  labels:
+    application.oam.dev: application-sample
+  name: application-sample
+  namespace: oam-test
+  ownerReferences:
+  - apiVersion: core.oam.dev/v1alpha2
+    controller: true
+    kind: Application
+    name: application-sample
+    uid: dca7acc3-664c-422b-aa52-4fe012e37974
+spec:
+  components:
+  - componentName: myweb
+    traits:
+    - trait:
+        apiVersion: core.oam.dev/v1alpha2
+        kind: ManualScalerTrait
+        spec:
+          replicaCount: 10
+status:
+  conditions:
+  - lastTransitionTime: "2020-12-02T12:12:52Z"
+    reason: Successfully reconciled resource
+    status: "True"
+    type: Synced
+  dependency: {}
+  workloads:
+  - componentName: myweb
+    componentRevisionName: myweb-v1
+    traits:
+    - traitRef:
+        apiVersion: core.oam.dev/v1alpha2
+        kind: ManualScalerTrait
+        name: myweb-trait-78fdd467d6
+    workloadRef:
+      apiVersion: apps/v1
+      kind: Deployment
+      name: myweb
+
+kubectl get component/myweb -oyaml
+
+// component is as follows
+apiVersion: core.oam.dev/v1alpha2
+kind: Component
+metadata:
+  labels:
+    application.oam.dev: application-sample
+  name: myweb
+  namespace: oam-test
+  ownerReferences:
+  - apiVersion: core.oam.dev/v1alpha2
+    controller: true
+    kind: Application
+    name: application-sample
+    uid: dca7acc3-664c-422b-aa52-4fe012e37974
+spec:
+  workload:
+    apiVersion: apps/v1
+    kind: Deployment
+    spec:
+      selector:
+        matchLabels:
+          app.oam.dev/component: myweb
+      template:
+        metadata:
+          labels:
+            app.oam.dev/component: myweb
+        spec:
+          containers:
+          - command:
+            - sleep
+            - "1000"
+            image: busybox
+            name: myweb
+status:
+  latestRevision:
+    name: myweb-v1
+    revision: 1      
+```
+

config/samples/vela-server/application-sample.yaml

@@ -0,0 +1,14 @@
+apiVersion: core.oam.dev/v1alpha2
+kind: Application
+metadata:
+  name: application-sample
+spec:
+  services:
+    myweb:
+      type: worker
+      image: "busybox"
+      cmd:
+      - sleep
+      - "1000"
+      scaler:
+        replicas: 10

config/samples/vela-server/template.yaml

@@ -0,0 +1,76 @@
+apiVersion: core.oam.dev/v1alpha2
+kind: WorkloadDefinition
+metadata:
+  name: worker
+  annotations:
+    definition.oam.dev/description: "Long-running scalable backend worker without network endpoint"
+spec:
+  definitionRef:
+    name: deployments.apps
+  extension:
+    template: |
+      output: {
+      	apiVersion: "apps/v1"
+      	kind:       "Deployment"
+      	spec: {
+      		selector: matchLabels: {
+      			"app.oam.dev/component": context.name
+      		}
+
+      		template: {
+      			metadata: labels: {
+      				"app.oam.dev/component": context.name
+      			}
+
+      			spec: {
+      				containers: [{
+      					name:  context.name
+      					image: parameter.image
+
+      					if parameter["cmd"] != _|_ {
+      						command: parameter.cmd
+      					}
+      				}]
+      			}
+      		}
+
+      		selector:
+      			matchLabels:
+      				"app.oam.dev/component": context.name
+      	}
+      }
+
+      parameter: {
+      	// +usage=Which image would you like to use for your service
+      	// +short=i
+      	image: string
+
+      	cmd?: [...string]
+      }
+---
+apiVersion: core.oam.dev/v1alpha2
+kind: TraitDefinition
+metadata:
+  annotations:
+    definition.oam.dev/description: "Manually scale the app"
+  name: scaler
+spec:
+  appliesToWorkloads:
+    - webservice
+    - worker
+  definitionRef:
+    name: manualscalertraits.core.oam.dev
+  workloadRefPath: spec.workloadRef
+  extension:
+    template: |-
+      output: {
+      	apiVersion: "core.oam.dev/v1alpha2"
+      	kind:       "ManualScalerTrait"
+      	spec: {
+      		replicaCount: parameter.replicas
+      	}
+      }
+      parameter: {
+      	//+short=r
+      	replicas: *1 | int
+      }

design/api/vela-restful-api-reference.md

@@ -426,7 +426,7 @@ Please also specify `traits` values if need to attach a trait to several traits
       "workload_name": "poc5",
       "flags": [
         {
-          "name": "replica",
+          "name": "replicas",
           "value": "4"
         }
       ]
@@ -444,7 +444,7 @@ sample response
 	"data": {
 		"name": "podspecworkload",
 		"type": "workload",
-		"template": "#Template: {\n\tapiVersion: \"core.oam.dev/v1alpha2\"\n\tkind:       \"PodSpecWorkload\"\n\tmetadata: name: podspecworkload.name\n\tspec: {\n\t\tcontainers: [{\n\t\t\timage: containerized.image\n\t\t\tname:  containerized.name\n\t\t\tports: [{\n\t\t\t\tcontainerPort: containerized.port\n\t\t\t\tprotocol:      \"TCP\"\n\t\t\t\tname:          \"default\"\n\t\t\t}]\n\t\t}]\n\t}\n}\ncontainerized: {\n\tname: string\n\t// +usage=specify app image\n\t// +short=i\n\timage: string\n\t// +usage=specify port for container\n\t// +short=p\n\tport: *6379 | int\n}\n",
+		"template": "#Template: {\n\tapiVersion: \"core.oam.dev/v1alpha2\"\n\tkind:       \"PodSpecWorkload\"\n\tmetadata: name: podspecworkload.name\n\tspec: {\n\t\tcontainers: [{\n\t\t\timage: containerized.image\n\t\t\tname:  containerized.name\n\t\t\tports: [{\n\t\t\t\tcontainerPort: containerized.port\n\t\t\t\tprotocol:      \"TCP\"\n\t\t\t\tname:          \"default\"\n\t\t\t}]\n\t\t}]\n\t}\n}\ncontainerized: {\n\tname: string\n\t// +usage=Which image would you like to use for your service\n\t// +short=i\n\timage: string\n\t// +usage=Which port do you want customer traffic sent to\n\t// +short=p\n\tport: *6379 | int\n}\n",
 		"parameters": [{
 			"name": "name",
 			"required": true,
@@ -455,13 +455,13 @@ sample response
 			"short": "i",
 			"required": true,
 			"default": "",
-			"usage": "specify app image",
+			"usage": "Which image would you like to use for your service",
 			"type": 16
 		}, {
 			"name": "port",
 			"short": "p",
 			"default": 6379,
-			"usage": "specify port for container",
+			"usage": "Which port do you want customer traffic sent to",
 			"type": 4
 		}],
 		"definition": "/Users/zhouzhengxi/.vela/capabilities/containerizedworkloads.core.oam.dev.cue",
@@ -492,13 +492,13 @@ sample response
 			"short": "i",
 			"required": true,
 			"default": "",
-			"usage": "specify app image",
+			"usage": "Which image would you like to use for your service",
 			"type": 16
 		}, {
 			"name": "port",
 			"short": "p",
 			"default": 6379,
-			"usage": "specify port for container",
+			"usage": "Which port do you want customer traffic sent to",
 			"type": 4
 		}]
 	}, {
@@ -534,7 +534,7 @@ sample request
   "name": "scale",
   "flags": [
     {
-      "name": "replica",
+      "name": "replicas",
       "value": "4"
     }
   ]
@@ -556,9 +556,9 @@ sample response
 	"data": {
 		"name": "manualscaler",
 		"type": "trait",
-		"template": "#Template: {\n\tapiVersion: \"core.oam.dev/v1alpha2\"\n\tkind:       \"ManualScalerTrait\"\n\tspec: {\n\t\treplicaCount: manualscaler.replica\n\t}\n}\nmanualscaler: {\n\t//+short=r\n\treplica: *2 | int\n}\n",
+		"template": "#Template: {\n\tapiVersion: \"core.oam.dev/v1alpha2\"\n\tkind:       \"ManualScalerTrait\"\n\tspec: {\n\t\treplicaCount: manualscaler.replicas\n\t}\n}\nmanualscaler: {\n\t//+short=r\n\treplicas: *2 | int\n}\n",
 		"parameters": [{
-			"name": "replica",
+			"name": "replicas",
 			"short": "r",
 			"default": 2,
 			"type": 4
@@ -675,7 +675,7 @@ sample response
 	"data": [{
 		"name": "podspecworkload",
 		"type": "workload",
-		"template": "#Template: {\n\tapiVersion: \"core.oam.dev/v1alpha2\"\n\tkind:       \"ContainerizedWorkload\"\n\tmetadata: name: podspecworkload.name\n\tspec: {\n\t\tcontainers: [{\n\t\t\timage: containerized.image\n\t\t\tname:  containerized.name\n\t\t\tports: [{\n\t\t\t\tcontainerPort: containerized.port\n\t\t\t\tprotocol:      \"TCP\"\n\t\t\t\tname:          \"default\"\n\t\t\t}]\n\t\t}]\n\t}\n}\ncontainerized: {\n\tname: string\n\t// +usage=specify app image\n\t// +short=i\n\timage: string\n\t// +usage=specify port for container\n\t// +short=p\n\tport: *6379 | int\n}\n",
+		"template": "#Template: {\n\tapiVersion: \"core.oam.dev/v1alpha2\"\n\tkind:       \"ContainerizedWorkload\"\n\tmetadata: name: podspecworkload.name\n\tspec: {\n\t\tcontainers: [{\n\t\t\timage: containerized.image\n\t\t\tname:  containerized.name\n\t\t\tports: [{\n\t\t\t\tcontainerPort: containerized.port\n\t\t\t\tprotocol:      \"TCP\"\n\t\t\t\tname:          \"default\"\n\t\t\t}]\n\t\t}]\n\t}\n}\ncontainerized: {\n\tname: string\n\t// +usage=Which image would you like to use for your service\n\t// +short=i\n\timage: string\n\t// +usage=Which port do you want customer traffic sent to\n\t// +short=p\n\tport: *6379 | int\n}\n",
 		"parameters": [{
 			"name": "name",
 			"required": true,
@@ -686,13 +686,13 @@ sample response
 			"short": "i",
 			"required": true,
 			"default": "",
-			"usage": "specify app image",
+			"usage": "Which image would you like to use for your service",
 			"type": 16
 		}, {
 			"name": "port",
 			"short": "p",
 			"default": 6379,
-			"usage": "specify port for container",
+			"usage": "Which port do you want customer traffic sent to",
 			"type": 4
 		}],
 		"definition": "/Users/zhouzhengxi/.vela/centers/c1/.tmp/containerizedworkloads.core.oam.dev.cue",
@@ -702,9 +702,9 @@ sample response
 	},{
 		"name": "rollout",
 		"type": "trait",
-		"template": "#Template: {\n\tapiVersion: \"extend.oam.dev/v1alpha2\"\n\tkind:       \"SimpleRolloutTrait\"\n\tspec: {\n\t\treplica:        rollout.replica\n\t\tmaxUnavailable: rollout.maxUnavailable\n\t\tbatch:          rollout.batch\n\t}\n}\nrollout: {\n\treplica:        *3 | int\n\tmaxUnavailable: *1 | int\n\tbatch:          *2 | int\n}\n",
+		"template": "#Template: {\n\tapiVersion: \"extend.oam.dev/v1alpha2\"\n\tkind:       \"SimpleRolloutTrait\"\n\tspec: {\n\t\treplicas:        rollout.replicas\n\t\tmaxUnavailable: rollout.maxUnavailable\n\t\tbatch:          rollout.batch\n\t}\n}\nrollout: {\n\treplicas:        *3 | int\n\tmaxUnavailable: *1 | int\n\tbatch:          *2 | int\n}\n",
 		"parameters": [{
-			"name": "replica",
+			"name": "replicas",
 			"default": 3,
 			"type": 4
 		}, {

design/vela-core/appfile-design.md

@@ -50,14 +50,14 @@ services:
       - /mnt/path=sec:my-secret
 
     scale:
-      replica: 2
+      replicas: 2
       auto: # automatic scale up and down based on given metrics
         range: "1-10"
         cpu: 80 # if cpu utilization is above 80%, scale up
         qps: 1000 # if qps is higher than 1k, scale up
 
     canary: # Auto-create canary deployment. Only upgrade after verify successfully.
-      replica: 1 # canary deployment size
+      replicas: 1 # canary deployment size
       headers:
         - "foo:bar.*"
 ```

design/vela-core/apply-once-only.md

@@ -0,0 +1,129 @@
+# Apply-Once-Only: Apply workload/trait only when spec is changed
+
+- Owner: Yue Wang(@captainroy-hy), Jianbo Sun(@wonderflow)
+- Date: 11/24/2020
+- Status: Implemented
+
+## Intro
+When an ApplicationConfiguration is deployed, 
+vela-core will create(apply) corresponding workload/trait instances and keep them stay align with the `spec` defined in ApplicationConfiguration through periodical reconciliation. 
+
+If we run vela-core with `--apply-once-only` flag enabled, vela-core will never apply the workload and trait instance after they are applied once. Even if they are changed by others (e.g., trait controller, workload controller,etc). 
+Since the create operation is the only one apply operation occurring on workload/trait, we call this mechanism as `Apply Once Only`.
+
+## A Motivational Example
+Here is a scenario from production environment to demonstrate how `Apply Once Only` works.
+
+```yaml
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  name: example-appconfig
+spec:
+  components:
+    - componentName: example-component
+---
+apiVersion: core.oam.dev/v1alpha2
+kind: Component
+metadata:
+  name: example-component
+spec:
+  workload:
+    apiVersion: apps/v1
+    kind: Deployment
+    spec:
+      ...
+      template:
+        spec:
+          containers:
+            - image: sample/app:1.0
+              name: sample-app
+```
+
+After deploying above ApplicationConfiguration, vela-core will create a Deployment with corresponding `PodTemplateSpec`. 
+
+In production env, it's possible to change the Deployment according to particular requirements, e.g., RolloutTrait, AutoscalerTrait,etc.
+Currently, we just use `kubectl` to simulate workload is changed bypass changing the ApplicationConfiguration. 
+Below cmd changes `spec.template.spec.containers[0].image` of the Deployment from `sample/app:1.0` to `sample/app:2.0`.
+```shell
+cat <<EOF | kubectl patch deployment example-deploy --patch
+spec:
+  template:
+    spec:
+      containers:
+      - name: sample-app
+        image: sample/app:2.0
+EOF
+```
+
+Above change will trigger recreate of Pods owned by the Deployment. 
+But vela-core will change it back to `sample/app:1.0` in the following reconciliation soon or late. 
+That's not what we expect in some scenarios.
+
+Instead, we hope vela-core ignore reconciling the workload we changed and leave them as what they are now until we change the `spec` of their parent ApplicationConfiguration .
+
+## Goals
+
+Add a startup parameter for vela-core controller to allow users choose whether to enable apply only once or not. 
+
+If enabled, workload/trait will be applied only one time for each resource generation (only when the corresponding appconfig/component is created or updated).
+After workload/trait created/updated and aligned to the generation of appconfig, vela-core will not apply them EXCEPT below situations:
+
+- The `spec` of ApplicationConfiguration is changed (new generation created)
+- The revision of Component is changed
+
+By default, the mechanism is disabled, vela-core will always reconcile and apply workload/trait periodically as usual.
+
+## Implementation
+
+In each round of reconciliation, vela-core compares below Labels & Annotations of existing workload/trait with newly rendered ones before applying.
+
+After deploying the ApplicationConfiguration in the motivational example, the Deployment created by vela-core will have such lables and annotations.
+
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  annotations:
+    deployment.kubernetes.io/revision: "1" 
+    app.oam.dev/generation: "1"
+  generation: 1
+  labels:
+    app.oam.dev/component: example-component
+    app.oam.dev/name: example-appconfig
+    app.oam.dev/resourceType: WORKLOAD
+    app.oam.dev/revision: example-component-v1
+  ...
+```
+
+- `annotations["app.oam.dev/generation"]:"1" ` refers to the generation of AppConfig
+- `labels["app.oam.dev/revision"]:"example-component-v1" ` refers to the revision of Component
+
+These crucial two are propogated from AppConfig and Component during reconciliation.
+Any change applied to the Deployment directly has no impact on these labels and annotations, e.g., change the Deployment spec just like what we do in the [motivational example](#a-motivational-example).
+If `--apply-once-only` is enabled, since no discrepancy is found on lables and annotations, 
+vela-core controller will ignore applying the Deployment and leave it as what it is at that moment.
+
+By contrast, changes on AppConfig (changing `spec` creates new generation) and Component (updating Component creates new revision) will change the value of these labels and annotations.
+For example, if we update the spec of AppConfig, newly rendered workload is supposed to contain such labels and annotations.
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  annotations:
+    deployment.kubernetes.io/revision: "1" 
+    app.oam.dev/generation: "2" # generation of AppConfig changed
+  generation: 1
+  labels:
+    app.oam.dev/component: example-component
+    app.oam.dev/name: example-appconfig
+    app.oam.dev/resourceType: WORKLOAD
+    app.oam.dev/revision: example-component-v1
+  ...
+```
+Since discrepancy is found, vela-core controller will apply(update) the Deployment with newly rendered one.
+Thus, the changes we made to the Deployment before will also be eliminated.
+
+The same mechanism also works for Trait as well as Workload.

design/vela-core/componenttrait-composing-and-trait-CR-naming.md

@@ -0,0 +1,155 @@
+# ComponentTrait Composing and Trait CR Naming
+
+* Owner: Jianbo Sun (@wonderflow), Zhou Zheng Xi (@zzxwill)
+* Reviewers: KubeVela/Crossplane Maintainers
+* Status: Draft
+
+## Background
+
+Now definition name is no longer coupled with CRD name, it's align to capability name  in KubeVela,
+and two TraitDefinition  resources can both refer to the same CRD. So it's necessary to specify how to assemble trait CR
+in ApplicationConfiguration and to set the CR name in a friendly way.
+
+## Several ways to assemble trait CR in ApplicationConfiguration
+
+- If the name of TraitDefinition is the same with the referenced CRD
+
+The normal way to assemble a trait CR works as below.
+
+```
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  name: example-appconfig
+spec:
+  components:
+    - componentName: example-component
+      traits:
+        - trait:
+            apiVersion: core.oam.dev/v1alpha2
+            kind: ManualScalerTrait
+            spec:
+              replicaCount: 3
+```
+
+- If the name of TraitDefinition is different to that of Trait CRD
+
+The definition name `autoscale` is different to the trait name `autoscalers.standard.oam.dev`, we have two ways to compose ComponentTrait.
+
+```
+apiVersion: core.oam.dev/v1alpha2
+kind: TraitDefinition
+metadata:
+  name: autoscale
+spec:
+  definitionRef:
+    name: autoscalers.standard.oam.dev
+```
+
+1) Use label `trait.oam.dev/type`
+
+```
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  name: example-appconfig
+spec:
+  components:
+    - componentName: example-component
+      traits:
+        - trait:
+            apiVersion: standard.oam.dev/v1alpha2
+            kind: Autoscalers
+            metadata:
+              labels:
+                trait.oam.dev/type: autoscale
+            spec:
+              replicaCount: 3
+```
+
+When rendering trait, the TraitDefinition could be retrieved by the label.
+
+2) Use `name` field
+
+```
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  name: example-appconfig
+spec:
+  components:
+    - componentName: example-component
+      traits:
+        - trait:
+            apiVersion: standard.oam.dev/v1alpha2
+            kind: Autoscalers
+            name: autoscale
+            spec:
+              replicaCount: 3
+```
+
+The mutating handler will, at the very beginning,  convert `name:autoscale` to the labels above.
+
+In summary, among these two ways to compose ComponentTrait, using labeling is recommended.
+
+While in KubeVela, you don't need to worry about either `label` or `name`, just use command `vela TraitType` or `vela up` to attach the trait to
+a component.
+
+## Set the CR name in a friendly way
+
+Currently, we named all trait name in the format of `${ComponentName}-trait-${HashTag}`. This will lead to confusions
+when listing CRs of all Traits of a component. 
+
+In this proposal, we propose to change the naming rule to `${ComponentName}-${TraitDefinitionName}-${HashTag}`.
+
+For example, if the name of TraitDefinition is `autoscale`, we name the trait CR to `example-component-autoscale-xyzfa32r`.
+
+```
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  name: example-appconfig
+spec:
+  components:
+    - componentName: example-component
+      traits:
+        - trait:
+            apiVersion: standard.oam.dev/v1alpha2
+            kind: Autoscalers
+            metadata:
+              labels:
+                trait.oam.dev/type: autoscale
+            spec:
+              replicaCount: 3
+```
+
+If the name is the same as the CRD name, like `manualscalertraits.core.oam.dev`, we name it to `example-component-manualscalertraits-rq234rrw`
+by choosing the first part.
+
+```
+apiVersion: core.oam.dev/v1alpha2
+kind: ApplicationConfiguration
+metadata:
+  name: example-appconfig
+spec:
+  components:
+    - componentName: example-component
+      traits:
+        - trait:
+            apiVersion: core.oam.dev/v1alpha2
+            kind: ManualScalerTrait
+            spec:
+              replicaCount: 3
+
+---
+apiVersion: core.oam.dev/v1alpha2
+kind: TraitDefinition
+metadata:
+  name: manualscalertraits.core.oam.dev
+spec:
+  workloadRefPath: spec.workloadRef
+  definitionRef:
+    name: manualscalertraits.core.oam.dev
+```
+
+After OAM Kubernetes Runtime is upgraded, the old trait CR name `example-component-trait-uewf77eu` will stay unchanged for previous version compatibility.

design/vela-core/migrate-from-oam-runtime.md

@@ -0,0 +1,152 @@
+# How to upgrade to KubeVela
+
+What if I want to upgrade from [oam-kubernetes-runtime](https://github.com/crossplane/oam-kubernetes-runtime) to KubeVela? Here's a detailed guide!
+
+## For users who are using OAM runtime as standalone controller
+
+If you are using OAM Runtime as Standalone Controller, upgrading to KubeVela to KubeVela is very straight forward.
+
+Server-side KubeVela(We call it `vela-core` for convenience) now includes following **BUILT-IN** CRDs and controllers.
+
+| Type |  CRD   | Controller  | From |
+| ---- |  ----  | ----  | ----  |
+| Control Plane Object | `applicationconfigurations.core.oam.dev` | Yes | OAM Runtime |
+| Control Plane Object | `components.core.oam.dev` | Yes | OAM Runtime |
+| Workload Type | `containerizedworklaods.core.oam.dev` | Yes | OAM Runtime |
+| Scope | `healthscope.core.oam.dev` | Yes | OAM Runtime |
+| Trait | `manualscalertraits.core.oam.dev` | Yes | OAM Runtime |
+| Control Plane Object | `scopedefinitions.core.oam.dev` | No | OAM Runtime |
+| Control Plane Object | `traitdefinitions.core.oam.dev` | No | OAM Runtime |
+| Control Plane Object | `workloaddefinitions.core.oam.dev` | No | OAM Runtime |
+| Trait | `autoscalers.standard.oam.dev` | Yes | New in KubeVela |
+| Trait | `metricstraits.standard.oam.dev` | Yes | New in KubeVela |
+| Workload Type | `podspecworkloads.standard.oam.dev` | Yes | New in KubeVela |
+| Trait | `route.standard.oam.dev` | Yes | New in KubeVela |
+
+CRDs and Controllers in the table from 'OAM Runtime' are exactly the same to those in `oam-kubernetes-runtime`.
+So in KubeVela we have added 4 more new CRDs with controller. 
+
+### Option 1: I only want to have OAM control plane objects only, no additional traits and workload types.
+
+1. Find you deployment
+
+```shell script
+$ kubectl -n oam-system get deployment -l app.kubernetes.io/name=oam-kubernetes-runtime
+NAME                         READY   UP-TO-DATE   AVAILABLE   AGE
+oam-kubernetes-runtime-oam   1/1     1            1           62s
+```
+
+2. Update the deployment
+
+In this case, the deployment name of OAM runtime is `oam-kubernetes-runtime-oam`, let's edit it to update the image:
+
+```shell script
+$ kubectl -n oam-system edit deployment oam-kubernetes-runtime-oam
+```
+
+There are two changes:
+
+- update the image from `crossplane/oam-kubernetes-runtime:latest` to `oamdev/vela-core:latest`
+- add an args `- "--disable-caps=all"`, which will disable all additional workloads and traits built in vela-core described in the following table.
+
+| Type | Current KubeVela Additional CRD   |
+| ---- |  ----  |
+| Trait | `autoscalers.standard.oam.dev` |
+| Trait | `metricstraits.standard.oam.dev` |
+| Workload | `podspecworkloads.standard.oam.dev` |
+| Trait | `route.standard.oam.dev` |
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: oam-kubernetes-runtime-oam
+...
+      containers:
+        - name: oam
+          args:
+            - "--metrics-addr=:8080"
+            - "--enable-leader-election"
++           - "--disable-caps=all"
+-         image: crossplane/oam-kubernetes-runtime:latest
++         image: oamdev/vela-core:latest
+          imagePullPolicy: "Always"
+...
+```
+
+### Option 2: I want full featured KubeVela, including its built-in workload types and traits.
+
+1. Install Additional CRDs
+
+```shell script
+$ kubectl apply -f charts/vela-core/crds
+```
+
+2. Install Definition files
+
+```shell script
+$ kubectl apply -f charts/vela-core/templates/defwithtemplate
+```
+
+3. Create namespace, vela-core use `vela-system` as default
+
+```shell script
+$ kubectl create ns vela-system
+```
+
+4. Install Cert Manager
+
+```shell script
+$ kubectl apply -f charts/vela-core/templates/cert-manager.yaml
+```
+
+5. Install Vela Dependency ConfigMap
+
+```shell script
+$ kubectl apply -f charts/vela-core/templates/velaConfig.yaml
+```
+
+6. Delete your old oam-runtime deployment
+
+Find the running deployment.
+
+```shell script
+$ kubectl -n oam-system get deployment -l app.kubernetes.io/name=oam-kubernetes-runtime
+NAME                         READY   UP-TO-DATE   AVAILABLE   AGE
+oam-kubernetes-runtime-oam   1/1     1            1           62s
+```
+
+Delete the deployment found.
+
+```shell script
+$ kubectl -n oam-system delete deployment oam-kubernetes-runtime-oam
+```
+
+7. Install Certificate and Webhook for the new controller
+
+```shell script
+$ helm template --release-name kubevela -n vela-system -s templates/webhook.yaml charts/vela-core/ | kubectl apply -f -
+```
+
+8. Install the new controller
+
+```shell script
+$ helm template --release-name kubevela -n vela-system -s templates/kubevela-controller.yaml charts/vela-core/ | kubectl apply -f -
+```
+
+> TIPS: If you want to disable webhook, change 'useWebhook' to be 'false' in  `charts/vela-core/values.yaml`
+
+Then you have successfully migrate from oam-kubernetes-runtime to KubeVela.
+
+## For users who are importing OAM runtime as library
+
+If you are importing `oam-kubernetes-runtime` as library, you can update your import headers.
+
+Files are refactored as below:
+
+| OLD |  NEW   | Usage  |
+| ---- |  ----  | ----  |
+| `github.com/crossplane/oam-kubernetes-runtime/apis/core` | `github.com/oam-dev/kubevela/apis/core.oam.dev` | API Spec Code |
+| `github.com/crossplane/oam-kubernetes-runtime/pkg/controller` | `github.com/oam-dev/kubevela/pkg/controller/core.oam.dev` | OAM Controller Code |
+| `github.com/crossplane/oam-kubernetes-runtime/pkg/oam` | `github.com/oam-dev/kubevela/pkg/oam` | OAM Common Lib Code |
+| `github.com/crossplane/oam-kubernetes-runtime/pkg/webhook` | `github.com/oam-dev/kubevela/pkg/webhook/core.oam.dev` | OAM Webhook Code |

design/vela-core/rollout.md

@@ -0,0 +1,27 @@
+# Rollout
+
+## Conflicts With
+
+### `Autoscale`
+
+When `Rollout` and `Autoscle` traits are attached to the same service, they two will fight over the number of instances during rollout. Thus, it's by design that `Rollout` will take over replicas control (specified by `.replicas` field) during rollout.
+
+> Note: in up coming releases, KubeVela will introduce a separate section in Appfile to define release phase configurations such as `Rollout`.
+
+## How `Rollout` works?
+
+`Rollout` trait implements progressive release process to rollout your app following [Canary strategy](https://martinfowler.com/bliki/CanaryRelease.html).
+
+In detail, `Rollout` controller will create a canary of your app , and then gradually shift traffic to the canary while measuring key performance indicators like HTTP requests success rate at the same time. 
+
+
+![alt](../../docs/resources/traffic-shifting-analysis.png)
+
+In this sample, for every `10s`, `5%` traffic will be shifted to canary from the primary, until the traffic on canary reached `50%`. At the mean time, the instance number of canary will automatically scale to `replicas: 2` per configured in Appfile.
+
+
+Based on analysis result of the KPIs during this traffic shifting, a canary will be promoted or aborted if analysis is failed. If promoting, the primary will be upgraded from v1 to v2, and traffic will be fully shifted back to the primary instances. So as result, canary instances will be deleted after the promotion finished.
+
+![alt](../../docs/resources/promotion.png)
+
+> Note: KubeVela's `Rollout` trait is implemented with [Weaveworks Flagger](https://flagger.app/) operator.

docs/_sidebar.md

@@ -1,64 +1,78 @@
 - Overview
   - [Introduction](/en/introduction.md)
-  - [Installation](/en/install.md)
-  - [Quick Start](/en/quick-start.md)
-  - [Concepts](/en/concepts.md)
+  - [Getting Started](/en/quick-start.md)
 
-- For Developers
-  - [Setting Up Deployment Environment](/en/developers/config-enviroments.md)
-  - [Initializing Application](/en/developers/app-init.md)
-  - [Setting Routes](/en/developers/set-route.md)
-  - [Setting Auto-scaling Policy](/en/developers/set-autoscale.md)
-  - [Setting Rollout Strategy](/en/developers/set-rollout.md)
-  - [Monitoring Application](/en/developers/set-metrics.md)
-  - [Using Appfile](/en/developers/devex/appfile.md)
-  - [Check Application Logs](/en/developers/check-logs.md)
-  - [Execute Commands in Container](/en/developers/exec-cmd.md)
-  - [Port Forward to Container](/en/developers/port-forward.md)
-  - [Configuring data/env in Application](/en/developers/config-app.md)
-  - [Consuming Cloud Services](/en/developers/cloud-service.md)
-  - [Managing Capabilities](/en/developers/cap-center.md)
-  - [Capability References](/en/developers/references/README.md)
-
-- For Platform Engineers
-  - [Extending KubeVela](/en/platform-engineers/extending-kubevela.md)
-
-- Internals
-  - [Design and Architecture](/en/design.md)
+- Using KubeVela
+  - Appfile
+    - [Learning Appfile](/en/developers/learn-appfile.md)
+  - Operating
+    - [Setting Routes](/en/developers/set-route.md)
+    - [Setting Auto-scaling Policy](/en/developers/set-autoscale.md)
+    - [Setting Rollout Strategy](/en/developers/set-rollout.md)
+    - [Setting Monitoring Policy](/en/developers/set-metrics.md)
+  - Debugging
+    - [Port Forwarding](/en/developers/port-forward.md)
+    - [Check Application Logs](/en/developers/check-logs.md)
+    - [Execute Commands in Container](/en/developers/exec-cmd.md)  
+  - Extensibility
+    - [Managing Capabilities](/en/developers/cap-center.md)
+  - Configuring
+    - [Setting Up Deployment Environment](/en/developers/config-enviroments.md)
+    - [Configuring data/env in Application](/en/developers/config-app.md)
+  - [Alternative Commands](/en/developers/alternative-cmd.md)
+- Extending KubeVela
+  - [Add Workload Type](/en/platform-engineers/workload-type.md)
+  - [Add Trait](/en/platform-engineers/trait.md)
+  - [Add Cloud Services](/en/platform-engineers/cloud-services.md)
 
 - Roadmap
   - [KubeVela Roadmap](/en/roadmap.md)
 
-- CLI Reference
-  - General
-    - [vela config](/en/cli/vela_config.md)
-    - [vela env](/en/cli/vela_env.md)
-    - [vela init](/en/cli/vela_init.md)
-    - [vela install](/en/cli/vela_install.md)
-    - [vela up](/en/cli/vela_up.md)
-    - [vela version](/en/cli/vela_version.md)
-  - Applications
-    - [vela delete](/en/cli/vela_delete.md)
-    - [vela exec](/en/cli/vela_exec.md)
-    - [vela logs](/en/cli/vela_logs.md)
-    - [vela ls](/en/cli/vela_ls.md)
-    - [vela port-forward](/en/cli/vela_port-forward.md)
-    - [vela show](/en/cli/vela_show.md)
-    - [vela status](/en/cli/vela_status.md)
-    - [vela svc](/en/cli/vela_svc.md)
-  - Workload Types
-    - [vela workloads](/en/cli/vela_workloads.md)
-  - Traits
-    - [vela traits](/en/cli/vela_traits.md)
-    - [vela scaler](/en/cli/vela_scaler.md)
-    - [vela route](/en/cli/vela_route.md)
-    - [vela autoscale](/en/cli/vela_autoscale.md)
-    - [vela rollout](/en/cli/vela_rollout.md)
-    - [vela metric](/en/cli/vela_metric.md)
-  - System
-    - [vela completion](/en/cli/vela_completion.md)
-    - [vela dashboard](/en/cli/vela_dashboard.md)
-    - [vela system](/en/cli/vela_system.md)
-    - [vela template](/en/cli/vela_template.md)
-  - Extensibility
-    - [vela cap](/en/cli/vela_cap.md)
+- References
+  - [Concepts and Glossaries](/en/concepts.md)
+  - [Appfile](/en/developers/references/devex/appfile.md)
+  - Capabilities
+    - Workload Types
+      - [Webservice](/en/developers/references/workload-types/webservice.md)
+      - [Task](/en/developers/references/workload-types/task.md)
+      - [Worker](/en/developers/references/workload-types/worker.md)
+    - Traits
+      - [Route](/en/developers/references/traits/route.md)
+      - [Autoscale](/en/developers/references/traits/autoscale.md)
+      - [Rollout](/en/developers/references/traits/rollout.md)
+      - [Metrics](/en/developers/references/traits/metrics.md)
+      - [Scaler](/en/developers/references/traits/scaler.md)
+  - CLI
+    - General
+      - [vela config](/en/cli/vela_config.md)
+      - [vela env](/en/cli/vela_env.md)
+      - [vela init](/en/cli/vela_init.md)
+      - [vela install](/en/cli/vela_install.md)
+      - [vela up](/en/cli/vela_up.md)
+      - [vela version](/en/cli/vela_version.md)
+    - Applications
+      - [vela delete](/en/cli/vela_delete.md)
+      - [vela exec](/en/cli/vela_exec.md)
+      - [vela logs](/en/cli/vela_logs.md)
+      - [vela ls](/en/cli/vela_ls.md)
+      - [vela port-forward](/en/cli/vela_port-forward.md)
+      - [vela show](/en/cli/vela_show.md)
+      - [vela status](/en/cli/vela_status.md)
+      - [vela svc](/en/cli/vela_svc.md)
+    - Workload Types
+      - [vela workloads](/en/cli/vela_workloads.md)
+    - Traits
+      - [vela traits](/en/cli/vela_traits.md)
+      - [vela scaler](/en/cli/vela_scaler.md)
+      - [vela route](/en/cli/vela_route.md)
+      - [vela autoscale](/en/cli/vela_autoscale.md)
+      - [vela rollout](/en/cli/vela_rollout.md)
+      - [vela metrics](/en/cli/vela_metric.md)
+    - System
+      - [vela completion](/en/cli/vela_completion.md)
+      - [vela dashboard](/en/cli/vela_dashboard.md)
+      - [vela system](/en/cli/vela_system.md)
+      - [vela template](/en/cli/vela_template.md)
+    - Extensibility
+      - [vela cap](/en/cli/vela_cap.md)
+  - [FAQ](/en/developers/references/devex/faq.md)

docs/en/README.md

@@ -1,4 +1,4 @@
-![alt](resources/KubeVela-03.png)
+![alt](../resources/KubeVela-03.png)
 
 *Make shipping applications more enjoyable.*
 

docs/en/cli/vela.md

@@ -20,24 +20,24 @@ vela [flags]
 ### SEE ALSO
 
 * [vela autoscale](vela_autoscale.md)	 - Attach autoscale trait to an app
-* [vela cap](vela_cap.md)	 - Capability Management
+* [vela cap](vela_cap.md)	 - Manage capability centers and installing/uninstalling capabilities
 * [vela completion](vela_completion.md)	 - Output shell completion code for the specified shell (bash or zsh)
-* [vela config](vela_config.md)	 - Manage application configurations
+* [vela config](vela_config.md)	 - Manage configurations
 * [vela dashboard](vela_dashboard.md)	 - Setup API Server and launch Dashboard
-* [vela delete](vela_delete.md)	 - Delete Applications
-* [vela env](vela_env.md)	 - Manage application environments
-* [vela exec](vela_exec.md)	 - Execute a command in a container
-* [vela init](vela_init.md)	 - Init an OAM Application
-* [vela install](vela_install.md)	 - Initialize vela on both client and server
+* [vela delete](vela_delete.md)	 - Delete an application
+* [vela env](vela_env.md)	 - Manage environments
+* [vela exec](vela_exec.md)	 - Execute command in a container
+* [vela init](vela_init.md)	 - Create scaffold for an application
+* [vela install](vela_install.md)	 - Install Vela Core with built-in capabilities
 * [vela logs](vela_logs.md)	 - Tail logs for application
 * [vela ls](vela_ls.md)	 - List services
-* [vela metric](vela_metric.md)	 - Attach metric trait to an app
-* [vela port-forward](vela_port-forward.md)	 - Forward one or more local ports to a Pod of a service in an application
+* [vela metrics](vela_metrics.md)	 - Attach metrics trait to an app
+* [vela port-forward](vela_port-forward.md)	 - Forward local ports to services in an application
 * [vela rollout](vela_rollout.md)	 - Attach rollout trait to an app
 * [vela route](vela_route.md)	 - Attach route trait to an app
 * [vela scaler](vela_scaler.md)	 - Attach scaler trait to an app
-* [vela show](vela_show.md)	 - Get details of an application
-* [vela status](vela_status.md)	 - get status of an application
+* [vela show](vela_show.md)	 - Show details of an application
+* [vela status](vela_status.md)	 - Show status of an application
 * [vela svc](vela_svc.md)	 - Manage services
 * [vela system](vela_system.md)	 - System management utilities
 * [vela template](vela_template.md)	 - Manage templates
@@ -46,4 +46,4 @@ vela [flags]
 * [vela version](vela_version.md)	 - Prints out build version information
 * [vela workloads](vela_workloads.md)	 - List workloads
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_autoscale.md

@@ -19,19 +19,13 @@ vela autoscale frontend
 ### Options
 
 ```
-      --days string       
+      --cpu-percent int   specify the value for CPU utilization, like 80, which means 80%
       --detach            detach trait from service
-      --duration string   
   -h, --help              help for autoscale
-      --maxReplicas int    (default 4)
-      --minReplicas int    (default 1)
-      --name string       
-      --replicas string    (default "2")
+      --max int           maximal replicas of the workload
+      --min int           minimal replicas of the workload
   -s, --staging           only save changes locally without real update application
-      --startAt string    
       --svc string        specify one service belonging to the application
-      --timezone string    (default "Asia/Shanghai")
-      --type string        (default "cron")
 ```
 
 ### Options inherited from parent commands
@@ -44,4 +38,4 @@ vela autoscale frontend
 
 * [vela](vela.md)	 - 
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap.md

@@ -1,10 +1,10 @@
 ## vela cap
 
-Capability Management
+Manage capability centers and installing/uninstalling capabilities
 
 ### Synopsis
 
-Capability Management with config, list, add, remove capabilities
+Manage capability centers and installing/uninstalling capabilities
 
 ### Options
 
@@ -26,4 +26,4 @@ Capability Management with config, list, add, remove capabilities
 * [vela cap ls](vela_cap_ls.md)	 - List capabilities from cap-center
 * [vela cap uninstall](vela_cap_uninstall.md)	 - Uninstall capability from cluster
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_center.md

@@ -20,10 +20,10 @@ Manage Capability Center with config, sync, list
 
 ### SEE ALSO
 
-* [vela cap](vela_cap.md)	 - Capability Management
+* [vela cap](vela_cap.md)	 - Manage capability centers and installing/uninstalling capabilities
 * [vela cap center config](vela_cap_center_config.md)	 - Configure (add if not exist) a capability center, default is local (built-in capabilities)
 * [vela cap center ls](vela_cap_center_ls.md)	 - List all capability centers
 * [vela cap center remove](vela_cap_center_remove.md)	 - Remove specified capability center
 * [vela cap center sync](vela_cap_center_sync.md)	 - Sync capabilities from remote center, default to sync all centers
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_center_config.md

@@ -33,4 +33,4 @@ vela cap center config mycenter https://github.com/oam-dev/catalog/cap-center
 
 * [vela cap center](vela_cap_center.md)	 - Manage Capability Center
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_center_ls.md

@@ -32,4 +32,4 @@ vela cap center ls
 
 * [vela cap center](vela_cap_center.md)	 - Manage Capability Center
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_center_remove.md

@@ -32,4 +32,4 @@ vela cap center remove mycenter
 
 * [vela cap center](vela_cap_center.md)	 - Manage Capability Center
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_center_sync.md

@@ -32,4 +32,4 @@ vela cap center sync mycenter
 
 * [vela cap center](vela_cap_center.md)	 - Manage Capability Center
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_install.md

@@ -31,6 +31,6 @@ vela cap install mycenter/route
 
 ### SEE ALSO
 
-* [vela cap](vela_cap.md)	 - Capability Management
+* [vela cap](vela_cap.md)	 - Manage capability centers and installing/uninstalling capabilities
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_ls.md

@@ -30,6 +30,6 @@ vela cap ls
 
 ### SEE ALSO
 
-* [vela cap](vela_cap.md)	 - Capability Management
+* [vela cap](vela_cap.md)	 - Manage capability centers and installing/uninstalling capabilities
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_cap_uninstall.md

@@ -31,6 +31,6 @@ vela cap uninstall route
 
 ### SEE ALSO
 
-* [vela cap](vela_cap.md)	 - Capability Management
+* [vela cap](vela_cap.md)	 - Manage capability centers and installing/uninstalling capabilities
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_completion.md

@@ -27,4 +27,4 @@ of vela commands.
 * [vela completion bash](vela_completion_bash.md)	 - generate autocompletions script for bash
 * [vela completion zsh](vela_completion_zsh.md)	 - generate autocompletions script for zsh
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_completion_bash.md

@@ -36,4 +36,4 @@ vela completion bash
 
 * [vela completion](vela_completion.md)	 - Output shell completion code for the specified shell (bash or zsh)
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_completion_zsh.md

@@ -33,4 +33,4 @@ vela completion zsh
 
 * [vela completion](vela_completion.md)	 - Output shell completion code for the specified shell (bash or zsh)
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_config.md

@@ -1,10 +1,10 @@
 ## vela config
 
-Manage application configurations
+Manage configurations
 
 ### Synopsis
 
-Manage application configurations under given env
+Manage configurations
 
 ### Options
 
@@ -26,4 +26,4 @@ Manage application configurations under given env
 * [vela config ls](vela_config_ls.md)	 - List configs
 * [vela config set](vela_config_set.md)	 - Set data for a config
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_config_del.md

@@ -30,6 +30,6 @@ vela config del <config-name>
 
 ### SEE ALSO
 
-* [vela config](vela_config.md)	 - Manage application configurations
+* [vela config](vela_config.md)	 - Manage configurations
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_config_get.md

@@ -30,6 +30,6 @@ vela config get <config-name>
 
 ### SEE ALSO
 
-* [vela config](vela_config.md)	 - Manage application configurations
+* [vela config](vela_config.md)	 - Manage configurations
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_config_ls.md

@@ -30,6 +30,6 @@ vela config ls
 
 ### SEE ALSO
 
-* [vela config](vela_config.md)	 - Manage application configurations
+* [vela config](vela_config.md)	 - Manage configurations
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_config_set.md

@@ -30,6 +30,6 @@ vela config set <config-name> KEY=VALUE K2=V2
 
 ### SEE ALSO
 
-* [vela config](vela_config.md)	 - Manage application configurations
+* [vela config](vela_config.md)	 - Manage configurations
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_dashboard.md

@@ -38,4 +38,4 @@ dashboard
 
 * [vela](vela.md)	 - 
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_delete.md

@@ -1,13 +1,13 @@
 ## vela delete
 
-Delete Applications
+Delete an application
 
 ### Synopsis
 
-Delete Applications
+Delete an application
 
 ```
-vela delete <APPLICATION_NAME>
+vela delete APP_NAME
 ```
 
 ### Examples
@@ -33,4 +33,4 @@ vela delete frontend
 
 * [vela](vela.md)	 - 
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_env.md

@@ -1,10 +1,10 @@
 ## vela env
 
-Manage application environments
+Manage environments
 
 ### Synopsis
 
-Manage application environments
+Manage environments
 
 ### Options
 
@@ -26,4 +26,4 @@ Manage application environments
 * [vela env ls](vela_env_ls.md)	 - List environments
 * [vela env set](vela_env_set.md)	 - Set an environment
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020

docs/en/cli/vela_env_delete.md

@@ -30,6 +30,6 @@ vela env delete test
 
 ### SEE ALSO
 
-* [vela env](vela_env.md)	 - Manage application environments
+* [vela env](vela_env.md)	 - Manage environments
 
-###### Auto generated by spf13/cobra on 10-Nov-2020
+###### Auto generated by spf13/cobra on 16-Nov-2020