{"id":13689488,"url":"https://github.com/operate-first/apps","last_synced_at":"2026-01-16T19:57:00.712Z","repository":{"id":37070439,"uuid":"298198191","full_name":"operate-first/apps","owner":"operate-first","description":"Operate-first application manifests","archived":false,"fork":false,"pushed_at":"2023-08-25T11:47:17.000Z","size":18384,"stargazers_count":51,"open_issues_count":6,"forks_count":136,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-02T00:32:06.554Z","etag":null,"topics":["hacktoberfest","hacktoberfest2022","kubernetes","kustomize"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/operate-first.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","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-09-24T07:13:57.000Z","updated_at":"2025-04-03T15:25:37.000Z","dependencies_parsed_at":"2024-01-14T17:17:46.320Z","dependency_job_id":"14cf3abf-9983-41b3-9304-a0c492bdc91c","html_url":"https://github.com/operate-first/apps","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/operate-first/apps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/operate-first%2Fapps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/operate-first%2Fapps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/operate-first%2Fapps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/operate-first%2Fapps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/operate-first","download_url":"https://codeload.github.com/operate-first/apps/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/operate-first%2Fapps/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28482151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["hacktoberfest","hacktoberfest2022","kubernetes","kustomize"],"created_at":"2024-08-02T15:01:49.773Z","updated_at":"2026-01-16T19:57:00.704Z","avatar_url":"https://github.com/operate-first.png","language":"Python","funding_links":[],"categories":["kubernetes"],"sub_categories":[],"readme":"# Operate-First Apps\n\nThis repository serves as a centralized source of truth for the Operate First Community Cloud Offering.\n\nIn this repository you will find various OCP/K8s manifests that define the desired state of all our clusters and different\nservices deployed on these clusters.\n\nAll manifests can be generated using [kustomize][kustomize]. Though some builds may include encrypted data that require\nadditional credentials (read more about how we encrypt files [here][encryption_docs]).\n\nAll manifests found through this repo are deployed by our [ArgoCD][argocd_instance].\n\n## Documentation\n\nAll documentation can be found [here][docs].\n\n## What is an \"App\"?\n\n_Apps_ or _Applications_ in this context refers to the ArgoCD notion of `Application`, as described in the\n[ArgoCD docs][argocd_core_concepts]. In short, you can think of an `App` as a collection of manifests that have a\ndestination cluster where they should be deployed.\n\n## How does it work?\n\n![](./docs/img/apps_repo.png)\n\nThis diagram provides a simple illustration of the structure of a typical `Application` in this repo. In this\nillustration you can imagine an `Application` to be any group of manifests. These manifests belonging to an\n`Application` often make up a full deployment of a service which has end users (e.g. `Grafana`). Though sometimes,\nan `Application` may be just be a way to logically group a collection of manifests, like in the case of `cluster-scope`\n`Application` which harbors all cluster wide resources, configurations, and privileged resources.\n\nOnce a group of manifests are organized into a directory, they can be deployed using ArgoCD. To do this you simply\nneed to create the application within ArgoCD, docs on how to do this can be found [here][argocd_add_app].\n\n## Repo structure\n\nYou will also notice each app adheres to a structure made up of `bases` and `overlays`. This is a structure commonly\nfound when using `Kustomize`. `base` directories contain manifests/configurations that are common to multiple clusters\nand generally don't harbor any cluster specific details. Within the `overlays` directory you'll find cluster specific\nconfigurations. A cluster specific folder within `Overlays` will inherit the manifests from `base` folders as needed,\nwhile also making patches/amendments specific to that cluster.\n\n## Contributing\n\nWe suggest ramping up on the following before attempting to work with the [Apps repo][apps_repo]:\n\n- [Openshift/K8s][learn_ocp]\n- [Kustomize][kustomize]\n- [ArgoCD][argocd_core_concepts]\n- [SOPS][sops] (if working with encrypted manifests)\n\nWe encourage you to browse around the following repos for issues you would be interested in tackling:\n\n- https://github.com/operate-first/apps\n- https://github.com/operate-first/support\n\nBeginner friendly issues are marked [\"Good first issue\"][good_first_issue]. Though you are welcome to take on any issue\nthat interests you. If an issue is unclear or requires more information, feel free to reach out to us.\n\nPlease be sure to read the contributing docs [here][contributing] before making a PR.\n\n[apps_repo]: https://github.com/operate-first/apps\n[docs]: https://www.operate-first.cloud/apps/content/README.html\n[kustomize]: https://kustomize.io/\n[encryption_docs]: https://www.operate-first.cloud/apps/content/argocd-gitops/encrypting_applications.html\n[argocd_instance]: https://argocd.operate-first.cloud/applications\n[argocd_core_concepts]: https://argo-cd.readthedocs.io/en/stable/core_concepts/\n[contributing]: https://github.com/operate-first/apps/blob/master/contributing.md\n[learn_ocp]: https://developers.redhat.com/learn\n[sops]: https://github.com/mozilla/sops\n[argocd_add_app]: https://www.operate-first.cloud/apps/content/argocd-gitops/add_application.html\n[good_first_issue]: https://github.com/search?q=org%3Aoperate-first+label%3A%22good+first+issue%22+is%3Aopen\u0026type=issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foperate-first%2Fapps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foperate-first%2Fapps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foperate-first%2Fapps/lists"}