Skip to content
This repository has been archived by the owner on Mar 24, 2023. It is now read-only.
/ merlin Public archive

Merlin is an agent sends out alerts when kubernetes resources are misconfigured or not comply with custom rules.

License

Notifications You must be signed in to change notification settings

mercari/merlin

Repository files navigation

Merlin

An agent that sends out alerts when kubernetes resources are misconfigured or have issues based on rules.

Technical background and designs

Please see Docs for detailed documentations

Installation

Install CRDs

In order to install merlin, you'll need to install the CRD (custom resource definition) first, run

make install

to install the CRDs

Uninstall CRDs

To uninstall CRDs, you can run:

make uninstall

Sample custom resources

Once CRDs are installed, you can start setting what rules you'd like to have, there are several samples under config/samples, you can run

make apply-samples

to apply all sample resources

Install controller manager

After you've applied the custom resources, run

make deploy

to install the controller.

Note this will create a namespace called merlin and install the controller manager in it.

Testing

You can run the tests with

make test

By default controller tests use envtest to run the tests, but you can change it to use existing cluster by setting environment varialbe USE_EXISTING_CLUSTER=1

for references, here is the list of environment variables can be used to change envtest's behavior.

Other tests uses testing and mock for unit testing and mocking API calls.

Debugging with existing cluster

You can also run the controllers locally against an existing cluster that your kube config points to, just run

make run

Committers

Contribution

Please read the CLA below carefully before submitting your contribution.

https://www.mercari.com/cla/

License

Copyright 2021 Mercari, Inc.

Licensed under the Apache 2.0 License.

About

Merlin is an agent sends out alerts when kubernetes resources are misconfigured or not comply with custom rules.

Resources

License

Stars

Watchers

Forks