mdebray/tvl-depot
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
tvl-depot/views/kit/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

27 lines
1.1 KiB
Markdown
Raw Normal View History

feat(kit): Export TVL kit as a josh workspace This creates a josh workspace called `views/kit` which exports all dependencies needed by external users of the TVL kit. The intention of this is to have a single clonable "virtual repo" which provides everything needed to run a system like TVL, but without the projects that we develop *in* TVL. Right now this is limited to the basic Nix code (readTree, pipeline generation) and things required for Gerrit integration. The workspace maps depot paths into slightly different (simpler) locations inside the exported view, to avoid a nested, mostly empty structure. Note: This is not an "external API" or some such of depot, it is simply a convenience for exporting some of our tooling. Change-Id: Ied24aaef117fc2e0c188ec742ae7cd993a5babd3 Reviewed-on: https://cl.tvl.fyi/c/depot/+/4991 Tested-by: BuildkiteCI Reviewed-by: sterni <sternenseemann@systemli.org>
2022-01-18 18:33:05 +03:00
The TVL Kit
===========
feat(views/kit): Check Buildkite pipeline into repository Change-Id: Id005703531ed3626c911b839d8f692f65a28e1e6 Reviewed-on: https://cl.tvl.fyi/c/depot/+/5053 Tested-by: BuildkiteCI Autosubmit: tazjin <tazjin@tvl.su> Reviewed-by: sterni <sternenseemann@systemli.org>
2022-01-22 16:20:40 +03:00
[![Build status](https://badge.buildkite.com/cd7240a881c7e77c3ed8cc040f81734623f57038563b37213d.svg?branch=canon)](https://buildkite.com/tvl/tvl-kit)
feat(kit): Export TVL kit as a josh workspace This creates a josh workspace called `views/kit` which exports all dependencies needed by external users of the TVL kit. The intention of this is to have a single clonable "virtual repo" which provides everything needed to run a system like TVL, but without the projects that we develop *in* TVL. Right now this is limited to the basic Nix code (readTree, pipeline generation) and things required for Gerrit integration. The workspace maps depot paths into slightly different (simpler) locations inside the exported view, to avoid a nested, mostly empty structure. Note: This is not an "external API" or some such of depot, it is simply a convenience for exporting some of our tooling. Change-Id: Ied24aaef117fc2e0c188ec742ae7cd993a5babd3 Reviewed-on: https://cl.tvl.fyi/c/depot/+/4991 Tested-by: BuildkiteCI Reviewed-by: sterni <sternenseemann@systemli.org>
2022-01-18 18:33:05 +03:00
This folder contains a publicly available version of the core TVL
tooling, currently comprising of:
* `buildkite`: TVL tooling for dynamically generating Buildkite
pipelines with Nix.
* `buildGo`: Nix-based build system for Go.
* `readTree`: Nix library to dynamically compute attribute trees
corresponding to the physical layout of a repository.
* `besadii`: Configurable Gerrit/Buildkite integration hook.
docs(views/kit): mention magrathea Change-Id: I3cf2d66fdc6c258ca9d3a502ce9eacc5926a8546 Reviewed-on: https://cl.tvl.fyi/c/depot/+/5703 Autosubmit: grfn <grfn@gws.fyi> Reviewed-by: tazjin <tazjin@tvl.su> Tested-by: BuildkiteCI
2022-05-27 18:13:57 -04:00
* `magrathea`: Command-line tool for working with TVL-style monorepos
feat(tvl-kit): Expose //tools/checks in tvl-kit This makes CI utility functions available in TVL kit. For now this is only the Terraform check, but said check has come up in other repos before so it's useful to centralise here (and we might add more!) Change-Id: I18acb19fc3407650ab9bad53dfba022dda498c07 Reviewed-on: https://cl.tvl.fyi/c/depot/+/5858 Autosubmit: tazjin <tazjin@tvl.su> Tested-by: BuildkiteCI Reviewed-by: asmundo <asmundo@gmail.com>
2022-06-07 09:34:12 +00:00
* `checks`: Collection of useful CI checks for Buildkite
feat(kit): Export TVL kit as a josh workspace This creates a josh workspace called `views/kit` which exports all dependencies needed by external users of the TVL kit. The intention of this is to have a single clonable "virtual repo" which provides everything needed to run a system like TVL, but without the projects that we develop *in* TVL. Right now this is limited to the basic Nix code (readTree, pipeline generation) and things required for Gerrit integration. The workspace maps depot paths into slightly different (simpler) locations inside the exported view, to avoid a nested, mostly empty structure. Note: This is not an "external API" or some such of depot, it is simply a convenience for exporting some of our tooling. Change-Id: Ied24aaef117fc2e0c188ec742ae7cd993a5babd3 Reviewed-on: https://cl.tvl.fyi/c/depot/+/4991 Tested-by: BuildkiteCI Reviewed-by: sterni <sternenseemann@systemli.org>
2022-01-18 18:33:05 +03:00
It can be accessed via git by cloning it as such:
fix(views/kit): communicate :unsign in the tvl-kit URL directly Instead of prepending :unsign to all URLs in josh-proxy, and for all calls to filteredGitPush, explicitly use it only in the filter we use for the `export-kit` extraStep. This means, people cloning tvl-kit via > https://code.tvl.fyi/depot.git:workspace=views/kit.git now need to update the URL to point to > https://code.tvl.fyi/depot.git:unsign:workspace=views/kit.git instead. git@github.com:tvlfyi/kit.git will keep the same hashes, as it's updated to export the unsigned workspace view of it. This is less invasive than dooming every josh workspace to have to strip signatures. Change-Id: I6de05182fad4c3695081388c3bbf37306521d255 Reviewed-on: https://cl.tvl.fyi/c/depot/+/8369 Autosubmit: flokli <flokli@flokli.de> Reviewed-by: tazjin <tazjin@tvl.su> Tested-by: BuildkiteCI
2023-03-30 16:30:22 +02:00
git clone https://code.tvl.fyi/depot.git:unsign:workspace=views/kit.git tvl-kit
feat(kit): Export TVL kit as a josh workspace This creates a josh workspace called `views/kit` which exports all dependencies needed by external users of the TVL kit. The intention of this is to have a single clonable "virtual repo" which provides everything needed to run a system like TVL, but without the projects that we develop *in* TVL. Right now this is limited to the basic Nix code (readTree, pipeline generation) and things required for Gerrit integration. The workspace maps depot paths into slightly different (simpler) locations inside the exported view, to avoid a nested, mostly empty structure. Note: This is not an "external API" or some such of depot, it is simply a convenience for exporting some of our tooling. Change-Id: Ied24aaef117fc2e0c188ec742ae7cd993a5babd3 Reviewed-on: https://cl.tvl.fyi/c/depot/+/4991 Tested-by: BuildkiteCI Reviewed-by: sterni <sternenseemann@systemli.org>
2022-01-18 18:33:05 +03:00
If you are looking at this within the TVL depot, you can see the
[josh][] configuration in `workspace.josh`. You will find the projects
at slightly different paths within the depot.
[josh]: https://github.com/josh-project/josh/
Reference in a new issue Copy permalink