{"id":22953063,"url":"https://github.com/devorbitus/skp","last_synced_at":"2025-09-19T07:10:08.537Z","repository":{"id":74328458,"uuid":"308396383","full_name":"devorbitus/skp","owner":"devorbitus","description":null,"archived":false,"fork":false,"pushed_at":"2020-10-29T17:06:03.000Z","size":152,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-07T15:34:40.387Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/devorbitus.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":"security/patch-basic-auth.yml","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-29T17:05:58.000Z","updated_at":"2020-10-29T17:06:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"ee02f3bd-05b6-44d9-9d3d-2479c8c426f4","html_url":"https://github.com/devorbitus/skp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"armory/spinnaker-kustomize-patches","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devorbitus%2Fskp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devorbitus%2Fskp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devorbitus%2Fskp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devorbitus%2Fskp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devorbitus","download_url":"https://codeload.github.com/devorbitus/skp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246730263,"owners_count":20824396,"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-12-14T15:52:14.147Z","updated_at":"2025-09-19T07:10:08.412Z","avatar_url":"https://github.com/devorbitus.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kustomize Patches for Armory\n\nThis repository contains example [Kustomize](https://kustomize.io) patch files to configure and deploy Armory using the [Armory Operator](https://docs.armory.io/docs/installation/operator/), which is a Kubernetes Operator for installing Armory.\n\nThe Armory Operator has `basic` and a `cluster` modes.\n\nFunctionality                                   | `basic` | `cluster`\n:-----------------------------------------------|:-------:|:--------:\nCan configure with single file                  |    Y    |     Y\nCan configure with kustomize patches            |    Y    |     Y\nOperator performs pre-flight checks/validations |    N    |     Y\nRequires Kubernetes 'cluster role'              |    N    |     Y\n\nEven though you can configure Armory in a single `SpinnakerService.yml` file, the advantage of using patch files is that each config section is its own file, with a `kustomization.yml` file that uses the patch files to build a deployment file. The Kustomize approach provides readability, consistency across environments, and maintenance manageability.  See the [Managing Configuration](https://docs.armory.io/docs/installation/operator/#managing-configuration) section of the Spinnaker Operator docs for details and examples.\n\nThis repo provides one-click installation of the Armory Operator (`cluster` mode) and Armory via the `deploy.sh` script. You don't have to read the Armory Operator documentation before you start, configure a manifest, or execute several commands to install Armory - `deploy.sh` does it all! Additionally, this repo has many example patch files that you can easily modify to match your environment - no more creating YAML files from scratch!\n\n## Disclaimer\n\nThe example configurations provided in this repository serve as a starting point for configuring Armory. You may need to modify the contents for the environment where Armory is running to work properly. These examples are not exhaustive and don't showcase all available combinations of settings. It's possible that not all configurations work with all versions of Armory.\n\nYou can use these patch files, with modification, to configure a Spinnaker\u003csup\u003eTM\u003c/sup\u003e instance installed using the the open source [Spinnaker Operator](https://github.com/armory/spinnaker-operator). You need to change the `apiVersion` by removing `armory` from it. For example,\n\n```\napiVersion: spinnaker.armory.io/v1alpha2\n```\n\nchanges to:\n\n```\napiVersion: spinnaker.io/v1alpha2\n```\n\nThe `deploy.sh` script automatically does this to deploy Spinnaker when you run it with the `SPIN_FLAVOR` environment variable:\n\n```bash\nSPIN_FLAVOR=oss ./deploy.sh\n\n```\n\n## Prerequisites\n\nYou need to have a working Kubernetes cluster and be able to execute `kubectl` commands against that cluster, with permissions to list and create namespaces.\n\n### Quick start\n\nClone this repository and run `./deploy.sh`.\n\nThis will deploy the Armory Operator to the `spinnaker-operator` namespace, and a base Armory instance to the `spinnaker` namespace with some default integrations.\n\n## General usage\n\n1. Make a link from `kustomization.yml` to one of the example kustomization files in `recipes` folder depending on your use case.\n1. Modify `kustomization.yml` by adding or removing patches depending on what you want to be included in spinnaker. [Kustomization Reference Documentation describes the syntax of this file](https://kubectl.docs.kubernetes.io/pages/reference/kustomize.html).\n1. Change any of the kustomize patch files to match your desired configuration. For example changing github username, aws account id, etc.\n1. Store secret literals in `secrets/secrets.env` and secret files in `secrets/files` if you want to store spinnaker secrets in Kubernetes. They are ignored by source control.\n1. Run `./deploy.sh` to deploy spinnaker.\n\n* Namespace for the Spinnaker Operator is configured in `operator/kustomization.yml`.\n* Namespace for Spinnaker and all its infrastructure is configured in `kustomization.yml`.\n* Spinnaker version is configured in `spinnakerservice.yml`.\n* Environment variable `SPIN_OP_DEPLOY` can be passed to deploy script to manage operator (default) or not (i.e. `SPIN_OP_DEPLOY=0 ./deploy.sh`)\n\nFor adding remote Kubernetes clusters to Spinnaker, the helper script `secrets/create-kubeconfig.sh` can be used to create a Kubernetes service account (with cluster admin role) and its corresponding `kubeconfig` file for spinnaker to use.\n\n## Resources\n\n* [Armory Operator](https://docs.armory.io/docs/installation/operator/)\n* [Armory Operator Configuration](https://docs.armory.io/docs/installation/operator-reference/operator-config/)\n* [Kustomize](https://kustomize.io)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevorbitus%2Fskp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevorbitus%2Fskp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevorbitus%2Fskp/lists"}