Skip to content

Commit

Permalink
Merge pull request #804 from carvel-dev/org-change-0.40.x
Browse files Browse the repository at this point in the history
Change org and repository name on line 0.40.x
  • Loading branch information
jtigger authored Feb 2, 2023
2 parents 31363ff + e693c00 commit 3244942
Show file tree
Hide file tree
Showing 13 changed files with 38 additions and 38 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/release-published.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ jobs:
validate-github-action:
runs-on: ubuntu-latest
steps:
- uses: vmware-tanzu/carvel-setup-action@v1
- uses: carvel-dev/setup-action@v1
with:
only: ytt
ytt: ${{ github.event.release.tag_name }}
Expand All @@ -25,7 +25,7 @@ jobs:
exit 1
fi
- run: |
curl -X POST https://api.github.com/repos/vmware-tanzu/carvel-release-scripts/dispatches \
curl -X POST https://api.github.com/repos/carvel-dev/release-scripts/dispatches \
-H 'Accept: application/vnd.github.everest-preview+json' \
-u ${{ secrets.carvel_bot_access_token }} \
--data '{"event_type": "ytt_released", "client_payload": { "tagName": "${{ github.event.release.tag_name }}", "repo": "${{ github.repository }}", "toolName": "ytt" }}'
4 changes: 2 additions & 2 deletions .github/workflows/trivy-scan.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ on:

jobs:
trivy-scan:
uses: vmware-tanzu/carvel-release-scripts/.github/workflows/trivy-scan.yml@main
uses: carvel-dev/release-scripts/.github/workflows/trivy-scan.yml@main
with:
repo: vmware-tanzu/carvel-ytt
repo: carvel-dev/ytt
tool: ytt
goVersion: 1.19.5
secrets:
Expand Down
4 changes: 2 additions & 2 deletions .goreleaser.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ snapshot:
release:
# Repo in which the release will be created.
github:
owner: vmware-tanzu
name: carvel-ytt
owner: carvel-dev
name: ytt

# If set to true, will not auto-publish the release.
draft: true
Expand Down
2 changes: 1 addition & 1 deletion GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
# ytt Governance
ytt governance can be found within the main [Carvel GitHub repo](https://github.com/vmware-tanzu/carvel) within the [GOVERNANCE.md](https://github.com/vmware-tanzu/carvel/blob/develop/GOVERNANCE.md) file.
ytt governance can be found within the main [Carvel GitHub repo](https://github.com/carvel-dev/carvel) within the [GOVERNANCE.md](https://github.com/carvel-dev/carvel/blob/develop/GOVERNANCE.md) file.
2 changes: 1 addition & 1 deletion MAINTAINERS.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
# ytt Maintainers
Maintainers for ytt can be found within the main [Carvel GitHub repo](https://github.com/vmware-tanzu/carvel) within the [MAINTAINERS.md](https://github.com/vmware-tanzu/carvel/blob/develop/MAINTAINERS.md) file.
Maintainers for ytt can be found within the main [Carvel GitHub repo](https://github.com/carvel-dev/carvel) within the [MAINTAINERS.md](https://github.com/carvel-dev/carvel/blob/develop/MAINTAINERS.md) file.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@
* Discover `ytt` in [video](https://youtu.be/KbB5tI_g3bo)
* For more information about annotations, data values, overlays and other features see [Docs](https://carvel.dev/ytt/docs/latest/) page
* Slack: [#carvel in Kubernetes slack](https://slack.kubernetes.io/)
* Install: Grab prebuilt binaries from the [Releases page](https://github.com/vmware-tanzu/carvel-ytt/releases) or [Homebrew Carvel tap](https://github.com/vmware-tanzu/homebrew-carvel)
* Backlog: [See what we're up to](https://app.zenhub.com/workspaces/carvel-backlog-6013063a24147d0011410709/board?repos=173207060). (Note: we use ZenHub which requires GitHub authorization).
* Install: Grab prebuilt binaries from the [Releases page](https://github.com/carvel-dev/ytt/releases) or [Homebrew Carvel tap](https://github.com/carvel-dev/homebrew)
* Backlog: [See what we're up to](https://github.com/orgs/carvel-dev/projects/1/views/1?filterQuery=repo%3A%22carvel-dev%2Fytt%22)).

## Overview

Expand All @@ -24,16 +24,16 @@
To get started with `ytt` and to see examples, you use the online playground or download the binaries and run the playground locally.

- Try out the [online playground](https://carvel.dev/ytt/#playground)
- Download the latest binaries from the [releases page](https://github.com/vmware-tanzu/carvel-ytt/releases) and run the playground locally: `ytt website`
- See the examples used in the playground on the [examples](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/examples/playground) page
- Download the latest binaries from the [releases page](https://github.com/carvel-dev/ytt/releases) and run the playground locally: `ytt website`
- See the examples used in the playground on the [examples](https://github.com/carvel-dev/ytt/tree/develop/examples/playground) page
- Editor Extensions: [vscode syntax highlighting](https://marketplace.visualstudio.com/items?itemName=ewrenn.vscode-ytt)

### Join the Community and Make Carvel Better
Carvel is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings. Details can be found on our [Carvel website](https://carvel.dev/community/).

You can chat with us on Kubernetes Slack in the #carvel channel and follow us on Twitter at @carvel_dev.

Check out which organizations are using and contributing to Carvel: [Adopter's list](https://github.com/vmware-tanzu/carvel/blob/master/ADOPTERS.md)
Check out which organizations are using and contributing to Carvel: [Adopter's list](https://github.com/carvel-dev/carvel/blob/master/ADOPTERS.md)

### Integrating with ytt

Expand Down
2 changes: 1 addition & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
# ytt Roadmap
The roadmap details for ytt can be found within the main [Carvel GitHub repo](https://github.com/vmware-tanzu/carvel) within the [ROADMAP.md](https://github.com/vmware-tanzu/carvel/blob/develop/ROADMAP.md) file.
The roadmap details for ytt can be found within the main [Carvel GitHub repo](https://github.com/carvel-dev/carvel) within the [ROADMAP.md](https://github.com/carvel-dev/carvel/blob/develop/ROADMAP.md) file.
32 changes: 16 additions & 16 deletions docs/dev.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
## Building

```bash
git clone https://github.com/vmware-tanzu/carvel-ytt ./src/github.com/vmware-tanzu/carvel-ytt
git clone https://github.com/carvel-dev/ytt ./src/github.com/carvel-dev/ytt
export GOPATH=$PWD
cd ./src/github.com/vmware-tanzu/carvel-ytt
cd ./src/github.com/carvel-dev/ytt

./hack/build.sh
./hack/test-unit.sh
Expand All @@ -12,30 +12,30 @@ cd ./src/github.com/vmware-tanzu/carvel-ytt
```

## Source Code Changes
To keep source code documentation up to date, ytt uses [godoc](https://go.dev/blog/godoc). To document a type, variable, constant, function, or a package, write a regular comment directly preceding its declaration that begins with the name of the element it describes. See the ["@ytt:ip" module](https://github.com/vmware-tanzu/carvel-ytt/blob/develop/pkg/yttlibrary/ip.go) for examples. When contributing new source code via a PR, the [GitHub Action linter](https://github.com/vmware-tanzu/carvel-ytt/blob/develop/.github/workflows/golangci-lint.yml) will ensure that godocs are included in the changes.
To keep source code documentation up to date, ytt uses [godoc](https://go.dev/blog/godoc). To document a type, variable, constant, function, or a package, write a regular comment directly preceding its declaration that begins with the name of the element it describes. See the ["@ytt:ip" module](https://github.com/carvel-dev/ytt/blob/develop/pkg/yttlibrary/ip.go) for examples. When contributing new source code via a PR, the [GitHub Action linter](https://github.com/carvel-dev/ytt/blob/develop/.github/workflows/golangci-lint.yml) will ensure that godocs are included in the changes.

To view the docs
1. install godoc: `go get -v golang.org/x/tools/cmd/godoc`
1. Start the server: `godoc -http=:6060` and visit [`http://localhost:6060/pkg/github.com/vmware-tanzu/carvel-ytt/`](http://localhost:6060/pkg/github.com/vmware-tanzu/carvel-ytt/).
1. Start the server: `godoc -http=:6060` and visit [`http://localhost:6060/pkg/github.com/carvel-dev/ytt/`](http://localhost:6060/pkg/github.com/carvel-dev/ytt/).

The go module was renamed from `github.com/k14s` to `github.com/vmware-tanzu/carvel-ytt` in February 2022. Carvel started out as a suite named "k14s" short for Kubernetes Tools.
The go module was renamed from `github.com/k14s` to `github.com/carvel-dev/ytt` in February 2022. Carvel started out as a suite named "k14s" short for Kubernetes Tools.

## Source Code Structure

For those interested in extending and improving `ytt`, below is a quick reference on the structure of the source code:

- [pkg/cmd/template/cmd.go](https://github.com/vmware-tanzu/carvel-ytt/blob/develop/pkg/cmd/template/cmd.go#L95) is the top level call site for the template command
- [pkg/files](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/files) allows reading files from filesystem
- [pkg/workspace](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/workspace) keeps read files from the filesystem in memory for later access
- [pkg/cmd/template/cmd.go](https://github.com/carvel-dev/ytt/blob/develop/pkg/cmd/template/cmd.go#L95) is the top level call site for the template command
- [pkg/files](https://github.com/carvel-dev/ytt/tree/develop/pkg/files) allows reading files from filesystem
- [pkg/workspace](https://github.com/carvel-dev/ytt/tree/develop/pkg/workspace) keeps read files from the filesystem in memory for later access
- `load(...)` directive goes through `TemplateLoader` to load files
- [pkg/yamlmeta](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/yamlmeta) parses YAML and tracks YAML node annotations (metas)
- [pkg/yamltemplate](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/yamltemplate) generates Starlark template based on yamlmeta package structures
- [pkg/texttemplate](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/texttemplate) parses text templates and generates Starlark template
- [pkg/template](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/template)
- [pkg/yamlmeta](https://github.com/carvel-dev/ytt/tree/develop/pkg/yamlmeta) parses YAML and tracks YAML node annotations (metas)
- [pkg/yamltemplate](https://github.com/carvel-dev/ytt/tree/develop/pkg/yamltemplate) generates Starlark template based on yamlmeta package structures
- [pkg/texttemplate](https://github.com/carvel-dev/ytt/tree/develop/pkg/texttemplate) parses text templates and generates Starlark template
- [pkg/template](https://github.com/carvel-dev/ytt/tree/develop/pkg/template)
- `InstructionSet` provides generic template instruction set for building Starlark templates
- `CompiledTemplate` uses [Starlark Go library](https://github.com/google/starlark-go) to evaluate Starlark code
- [pkg/yttlibrary](https://github.com/vmware-tanzu/carvel-ytt/tree/develop/pkg/yttlibrary) is bundled `@ytt` library
- you can also make your own libraries as exemplified by [vmware-tanzu/carvel-ytt-library-for-kubernetes](https://github.com/vmware-tanzu/carvel-ytt-library-for-kubernetes)
- [pkg/yttlibrary](https://github.com/carvel-dev/ytt/tree/develop/pkg/yttlibrary) is bundled `@ytt` library
- you can also make your own libraries as exemplified by [carvel-dev/ytt-library-for-kubernetes](https://github.com/carvel-dev/ytt-library-for-kubernetes)

### Tests

Expand Down Expand Up @@ -103,5 +103,5 @@ When contributing to this library note:
### Prior Efforts

For your convenience, here's a list of PRs of prior contributions to the standard library:
- [module for handling Internet Protocol data #433](https://github.com/vmware-tanzu/carvel-ytt/pull/433)
- [Add url type in the url module #372](https://github.com/vmware-tanzu/carvel-ytt/pull/372)
- [module for handling Internet Protocol data #433](https://github.com/carvel-dev/ytt/pull/433)
- [Add url type in the url module #372](https://github.com/carvel-dev/ytt/pull/372)
8 changes: 4 additions & 4 deletions examples/integrating-with-ytt/apis.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@ How one does this depends largely on the platform from which you're integrating.

Examples of how this can be done in Go:

- https://github.com/vmware-tanzu/carvel-kapp-controller/blob/develop/pkg/template/ytt.go
- https://github.com/vmware-tanzu/terraform-provider-carvel/blob/develop/pkg/ytt/ytt.go
- https://github.com/carvel-dev/kapp-controller/blob/develop/pkg/template/ytt.go
- https://github.com/carvel-dev/terraform-provider-carvel/blob/develop/pkg/ytt/ytt.go


## As a Go Module
Expand Down Expand Up @@ -57,10 +57,10 @@ Examples of how this can be done in Go:

### Examples
- [./internal-templating/main.go](internal-templating/main.go) — "Hello, world" with ytt.
- https://github.com/vmware-tanzu/carvel-kapp/blob/develop/pkg/kapp/yttresmod/overlay_contract_v1_mod.go — using `ytt` to overlay some existing YAML (here, a Kubernetes resource).
- https://github.com/carvel-dev/kapp/blob/develop/pkg/kapp/yttresmod/overlay_contract_v1_mod.go — using `ytt` to overlay some existing YAML (here, a Kubernetes resource).

# Next Steps

We are always happy to support you in your use of `ytt`. You can:
- find us at [Kubernetes Slack: #carvel](https://kubernetes.slack.com/archives/CH8KCCKA5) (if your not yet in the workspace, get an [invite](http://slack.k8s.io/)).
- [pose a question](https://github.com/vmware-tanzu/carvel-ytt/discussions) or [report an issue](https://github.com/vmware-tanzu/carvel-ytt/issues/new/choose) in our GitHub repo.
- [pose a question](https://github.com/carvel-dev/ytt/discussions) or [report an issue](https://github.com/carvel-dev/ytt/issues/new/choose) in our GitHub repo.
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@
#! is not accessible to library consumers, allowing the
#! library to have private functionality

#@ load("@github.com/vmware-tanzu/test-lib:funcs.star", "testfunc")
#@ load("@github.com/carvel-dev/test-lib:funcs.star", "testfunc")

result: #@ testfunc()
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ readme: |
(i.e. `namespace`), we expected it to be in
a target document, but it was not."
(we're working to make these error messages more easily
read; see https://github.com/vmware-tanzu/carvel-ytt/issues/95).
read; see https://github.com/carvel-dev/ytt/issues/95).
a) which "target document" does not have a `namespace`
map item under `metadata`?
Expand Down
2 changes: 1 addition & 1 deletion proposals/001-schemas/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Schemas

_(This document has been relocated to https://github.com/vmware-tanzu/carvel/tree/develop/proposals/ytt/001-schemas)_
_(This document has been relocated to https://github.com/carvel-dev/carvel/tree/develop/proposals/ytt/001-schemas)_
2 changes: 1 addition & 1 deletion proposals/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Proposals

Find proposals and other design documents in https://github.com/vmware-tanzu/carvel/tree/develop/proposals
Find proposals and other design documents in https://github.com/carvel-dev/carvel/tree/develop/proposals

0 comments on commit 3244942

Please sign in to comment.