{"id":18834867,"url":"https://github.com/kapicorp/kapitan-reference","last_synced_at":"2025-04-09T16:13:16.281Z","repository":{"id":37425440,"uuid":"240791533","full_name":"kapicorp/kapitan-reference","owner":"kapicorp","description":"Reference structure for Kapitan - alpha version","archived":false,"fork":false,"pushed_at":"2024-12-17T13:37:54.000Z","size":1419,"stargazers_count":46,"open_issues_count":10,"forks_count":24,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T16:13:12.441Z","etag":null,"topics":["jsonnet","kapitan","kubernetes","templates","terraform"],"latest_commit_sha":null,"homepage":"https://www.kapicorp.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kapicorp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-15T21:39:50.000Z","updated_at":"2025-02-11T14:29:31.000Z","dependencies_parsed_at":"2024-12-17T13:27:46.433Z","dependency_job_id":"41e98a26-e6da-4de9-8e15-a6b59bbc32c5","html_url":"https://github.com/kapicorp/kapitan-reference","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapicorp%2Fkapitan-reference","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapicorp%2Fkapitan-reference/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapicorp%2Fkapitan-reference/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kapicorp%2Fkapitan-reference/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kapicorp","download_url":"https://codeload.github.com/kapicorp/kapitan-reference/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065282,"owners_count":21041872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jsonnet","kapitan","kubernetes","templates","terraform"],"created_at":"2024-11-08T02:14:01.766Z","updated_at":"2025-04-09T16:13:16.247Z","avatar_url":"https://github.com/kapicorp.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kapitan Reference Setup \n\n[![CI](https://github.com/kapicorp/kapitan-reference/actions/workflows/integration-test.yml/badge.svg?event=push)](https://github.com/kapicorp/kapitan-reference/actions/workflows/integration-test.yml)\n\n\nThis repository is meant to be a way to bootstrap your [Kapitan](https://kapitan.dev) setup to get you up and running.\n\nIt is meant to help you make use of best practices and libraries that can make Kapitan the ultimate tool for all your configuration needs.\n\nLook at the branch [`init`](https://github.com/kapicorp/kapitan-reference/tree/init) for a clean setup with only the basics enabled.\n\n\n## Quickstart\n\n```shell script\n$ git clone git@github.com:kapicorp/kapitan-reference.git kapitan-templates\n$ cd kapitan-templates\n\n$ ./kapitan compile\nRendered inventory (3.45s)\nCompiled pritunl (0.23s)\nCompiled vault (0.27s)\nCompiled examples (0.28s)\nCompiled gke-pvm-killer (0.10s)\nCompiled mysql (0.10s)\nCompiled postgres-proxy (0.11s)\nCompiled sock-shop (0.23s)\nCompiled echo-server (0.11s)\nCompiled global (0.09s)\nCompiled guestbook-argocd (0.12s)\nCompiled tutorial (0.15s)\nCompiled kapicorp-project-123 (0.09s)\nCompiled kapicorp-terraform-admin (0.10s)\nCompiled tesoro (0.13s)\nCompiled dev-sockshop (0.24s)\nCompiled prod-sockshop (0.27s)\nCompiled argocd (0.99s)\nCompiled github-actions (6.99s)\n```\n\n## Generators documentation (IN PROGRESS)\n\n[generators.kapitan.dev](https://generators.kapitan.dev/)\n\n### Tools\n\nThis repo comes already with some helper tools. We will expand it as the time goes.\n\nFor now, you can see that the [`./kapitan`](kapitan) file is a wrapper script that allows you to run kapitan without installing any binary (it does depends on docker!)\n\n\n| Script    | Description                      |\n|-----------|----------------------------------|\n| ./kapitan | Wrapper script to invoke kapitan |\n\n\n### Libraries\n\nThis repo already packs some important libraries that you will want to have when working with kapitan.\n\n| Name    | Description            | Inventory file                                       |\n|---------|------------------------|------------------------------------------------------|\n| kgenlib | Kapitan Generators SKD | [kgenlib.yml](inventory/classes/kapitan/generators/kgenlib.yml) |\n\n\n### External Dependencies\n\nKapitan allows you to manage external dependencies like the above libraries.\nThis repo enables fetching by default through the `.kapitan` file, which only fetches missing dependencies.\n\n```yaml\nversion: 0.32\ncompile:\n  prune: true\n  embed-refs: true\n  fetch: true    # Automatically fetches missing dependencies.\n```\n\nTo update them from the upstream version, force fetch by running:\n\n```shell script\n./kapitan compile --force-fetch\nDependency https://github.com/kapicorp/generators.git: saved to system/lib\nDependency https://github.com/kapicorp/generators.git: saved to system/generators/kubernetes\nDependency https://github.com/kapicorp/generators.git: saved to system/generators/terraform\nDependency argo-cd: saved to system/sources/charts/argo-cd/argo-cd/3.32.0/v2.2.3\nRendered inventory (3.45s)\nCompiled vault (0.27s)\nCompiled pritunl (0.27s)\nCompiled examples (0.32s)\nCompiled gke-pvm-killer (0.10s)\nCompiled mysql (0.10s)\nCompiled postgres-proxy (0.10s)\nCompiled sock-shop (0.23s)\nCompiled echo-server (0.11s)\nCompiled global (0.09s)\nCompiled tutorial (0.14s)\nCompiled guestbook-argocd (0.11s)\nCompiled kapicorp-project-123 (0.09s)\nCompiled kapicorp-terraform-admin (0.09s)\nCompiled tesoro (0.13s)\nCompiled dev-sockshop (0.24s)\nCompiled prod-sockshop (0.27s)\nCompiled argocd (0.97s)\nCompiled github-actions (7.13s)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkapicorp%2Fkapitan-reference","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkapicorp%2Fkapitan-reference","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkapicorp%2Fkapitan-reference/lists"}