Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/switcherapi/switcher-gitops

GitOps Domain Snapshot Orquestrator for Switcher API
https://github.com/switcherapi/switcher-gitops

feature-flags gitops golang

Last synced: about 1 month ago
JSON representation

GitOps Domain Snapshot Orquestrator for Switcher API

Host: GitHub
URL: https://github.com/switcherapi/switcher-gitops
Owner: switcherapi
License: mit
Created: 2024-02-04T21:46:02.000Z (11 months ago)
Default Branch: master
Last Pushed: 2024-09-17T02:16:45.000Z (4 months ago)
Last Synced: 2024-09-17T15:02:29.552Z (4 months ago)
Topics: feature-flags, gitops, golang
Language: Go
Homepage:
Size: 155 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        ***



Switcher GitOps


GitOps Domain Snapshot Orchestrator for Switcher API





[![Master CI](https://github.com/switcherapi/switcher-gitops/actions/workflows/master.yml/badge.svg?branch=master)](https://github.com/switcherapi/switcher-gitops/actions/workflows/master.yml)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=switcherapi_switcher-gitops&metric=alert_status)](https://sonarcloud.io/dashboard?id=switcherapi_switcher-gitops)

[![Known Vulnerabilities](https://snyk.io/test/github/switcherapi/switcher-gitops/badge.svg)](https://snyk.io/test/github/switcherapi/switcher-gitops)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Docker Hub](https://img.shields.io/docker/pulls/trackerforce/switcher-gitops.svg)](https://hub.docker.com/r/trackerforce/switcher-gitops)

[![Slack: Switcher-HQ](https://img.shields.io/badge/slack-@switcher/hq-blue.svg?logo=slack)](https://switcher-hq.slack.com/)



***

![Switcher API: Cloud-based Feature Flag API](https://github.com/switcherapi/switcherapi-assets/blob/master/logo/switcherapi_gitops.png)

# About  

**Switcher GitOps** is used to orchestrate Domain Snapshots for Switcher API. It allows managing feature flags and configurations lifecycle.

- Manages Switchers with GitOps workflow (repository as a source of truth)

- Repository synchronization allows integrated tools such as Switcher API Management and Switcher Slack App to work in sync

- Flexible settings allow you to define the best workflow for your organization

- Orchestrates accounts per Domain environments allowing seamless integration with any branching strategy

# Getting Started

## Using Swither API Cloud

Switcher GitOps is available as a cloud-hosted service. You can sign up for a free account at [Switcher API Cloud](https://cloud.switcherapi.com).

1. Create and Configure a new Domain

2. Select the Domain and click on the Menu toolbar

3. Under Integrations, select Switcher GitOps

4. Follow the instructions to set up the repository

## Self-hosted: Deploying to Kubernetes

### Requirements

- Kubernetes cluster

- Helm 3

- Switcher API & Switcher Management

- Git Token (read/write access) for the repository

Find detailed instructions on how to deploy Switcher GitOps to Kubernetes [here](https://github.com/switcherapi/helm-charts).

## Development: Deploying locally

### Requirements

- Docker & docker-compose

- Switcher API & Switcher Management

- Git Token (read/write access) for the repository

1. Configure Switcher API to allow Switcher GitOps to access the API


Set SWITCHER_GITOPS_JWT_SECRET for Switcher API and SWITCHER_API_JWT_SECRET for Switcher GitOps.

2. [Start](https://github.com/switcherapi/switcher-api?tab=readme-ov-file#running-switcher-api-from-docker-composer-manifest-file) Switcher API and Switcher Management

3. Start Switcher GitOps `docker-compose -d up`


You might need to remove mongodb setting from docker-compose.yml if launching the full Switcher API stack from step 2.

## Development: Running locally

### Requirements

- Go [check version in go.mod]

- MongoDB +7.0

1. Clone the repository

2. Configure the environment variables in the `.env.test` file

3. `make run-test` to start the application

# Integrated tests

Set up PAT (Personal Access Token) for Switcher GitOps to access the repository. You can either create a fine-grained token with only the necessary permissions such as Content (Read and Write) and Metadata (Read) or use a personal token with full access.

Once you have the token, you can set it up in the `.env.test` environment file by including the following:

```bash

GIT_USER=[YOUR_GIT_USER]

GIT_TOKEN=[YOUR_GIT_TOKEN]

GIT_TOKEN_READ_ONLY=[YOUR_GIT_TOKEN_READ_ONLY]

GIT_REPO_URL=[YOUR_GIT_REPO_URL]

GIT_BRANCH=[YOUR_GIT_BRANCH]

GIT_PATH=[YOUR_GIT_PATH]

```