{"id":16880576,"url":"https://github.com/squaremo/flux-models","last_synced_at":"2026-05-17T13:17:11.331Z","repository":{"id":66130711,"uuid":"262044004","full_name":"squaremo/flux-models","owner":"squaremo","description":"Building blocks for putting together configs for Flux to sync","archived":false,"fork":false,"pushed_at":"2020-05-12T05:38:48.000Z","size":35,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-25T05:41:13.390Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/squaremo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-05-07T12:27:37.000Z","updated_at":"2020-05-12T05:38:50.000Z","dependencies_parsed_at":"2023-02-24T08:00:21.123Z","dependency_job_id":null,"html_url":"https://github.com/squaremo/flux-models","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/squaremo%2Fflux-models","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squaremo%2Fflux-models/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squaremo%2Fflux-models/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/squaremo%2Fflux-models/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/squaremo","download_url":"https://codeload.github.com/squaremo/flux-models/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244544305,"owners_count":20469659,"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":[],"created_at":"2024-10-13T15:59:18.789Z","updated_at":"2026-05-17T13:17:06.297Z","avatar_url":"https://github.com/squaremo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kpt packages for use with Flux\n\nWhat is this? A set of prepared packages for using with Flux.\n\n## How to use the packages\n\nIn general:\n\n```sh\n$ kpt pkg get https://github.com/squaremo/models.git/\u003cmodel\u003e\n# ...\n$ kpt cfg list-setters ./\u003cmodel\u003e\n# ...\n$ kpt cfg set \u003cmodel\u003e ./\u003cmodel\u003e \u003csetter\u003e \u003cvalue\u003e\n```\n\nSpecifically:\n\n### How to bootstrap clusters with the flux-readonly model\n\nCreate a repo for the bootstrap config:\n\n```sh\n$ mkdir bootstrap\n$ cd bootstrap\n$ git init\n# You will need to create an empty repo in github, and set your own URL here\n$ REPO_BOOTSTRAP=https://github.com/squaremo/bootstrap\n# ... then use the SSH equivalent here\n$ git remote add origin ssh://git@github.com/squaremo/bootstrap\n# ... finally, just to get any commits github did for you\n$ git pull origin master\n```\n\nNow to add a model for Flux to self-sustain:\n\n```sh\n# This one is fixed -- you don't supply your own.\n$ REPO_MODELS=https://github.com/squaremo/flux-models.git\n$ kpt pkg get $REPO_MODELS/flux-readonly flux\nfetching package /flux-readonly from https://github.com/squaremo/flux-models to flux\n$ git add flux\n$ git commit -m \"Add flux-readonly model as flux/\"\n$ kpt cfg list-setters ./flux\n   NAME                     VALUE                    SET BY   DESCRIPTION   COUNT\n  git-url   git@github.com:fluxcd/flux-get-started                          1\n$ kpt cfg set ./flux git-url $REPO_BOOTSTRAP\nset 1 fields\n$ git add -u\n$ git commit -m \"Set Flux git URL to this repository\"\n$ git push origin master\n# ...\n```\n\nNow, if you apply the configuration to a cluster, you will bootstrap a\ngit-syncing process that applies Flux and whatever else you put in\nyour bootstrap repo:\n\n```sh\n$ kubectl apply -f ./flux\n# ...\n$ kubectl logs -n flux-system deploy/flux -f\n# logs ...\n# logs ...\n# logs ...\n```\n\n### How to run the ArgoCD model\n\nOnce you have a self-sustaining Flux installation, you can add things\nto the repo and they will be applied. For example, the ArgoCD model:\n\n```\n$ kpt pkg get $REPO_MODELS/argocd argocd\nfetching package /argocd from https://github.com/squaremo/flux-models to argocd\n$ git add argocd\n$ git commit -m \"Added argocd model as argocd/\"\n$ kpt cfg list-setters ./argocd\n    NAME          VALUE       SET BY   DESCRIPTION   COUNT\n  namespace   argocd-system                          28\n$ # Nothing needs changing\n$ git push origin master\n```\n\n(NB the model runs ArgoCD in the namespace `argocd-system`, which is\ndifferent to the regular ArgoCD installation. This affects the\nport-forward later on.)\n\nIt might take a while for Flux to sync it, since it's just polling\n(you could set up [webhooks](https://github.com/fluxcd/flux-recv) --\nmaybe later). You can watch the logs to see when something happens:\n\n```sh\n$ kubectl logs -n flux-system deploy/flux -f\n# logs logs logs ...\nts=2020-05-12T05:33:04.7525229Z caller=loop.go:133 component=sync-loop event=refreshed url=https://@github.com/squaremo/flux-models-bootstrap branch=master HEAD=d1b2d98c951d28cff9cbf8344c44d908e91c9b09\n```\n\nNow you should be able to bring up the ArgoCD user interface, by\nrunning a port-forward:\n\n```sh\n$ kubectl port-forward svc/argocd-server -n argocd-system 8083:443 \u0026\n```\n\n.. and open a browser tab on https://localhost:8083 (it may complain\nthat the server certificate is not signed for localhost, which you'll\nhave to click through).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquaremo%2Fflux-models","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquaremo%2Fflux-models","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquaremo%2Fflux-models/lists"}