Giter VIP home page Giter VIP logo

calkines / config-generator Goto Github PK

View Code? Open in Web Editor NEW

This project forked from rudderlabs/config-generator

0.0 1.0 0.0 6.91 MB

Repo for RudderStack's Config Generator, that generates configuration JSON files to be used with the RudderStack server.

Home Page: https://rudderstack.com/

License: MIT License

JavaScript 1.79% HTML 0.61% CSS 1.52% TypeScript 94.85% SCSS 1.16% Dockerfile 0.07%

config-generator's Introduction

What is RudderStack?

RudderStack is a customer data pipeline tool for collecting, routing and processing data from your websites, apps, cloud tools, and data warehouse.

More information on RudderStack can be found here.

RudderStack Config Generator

Rudderstack has two components: control plane and data plane.

The data plane reliably delivers your event data, while the control plane manages the configuration of your sources and destinations. This configuration can also be read from a file instead of from the control plane, if you want remove an extra dependency.

RudderStack Config Generator provides the UI to manage the source and destination configurations without needing to sign up. All the source and destination configuration stays on your local storage. You can export/import config to a JSON file.

Setup

  1. npm install
  2. npm start

RudderStack config generator starts on the default port i.e., http://localhost:3000. On a successful setup, you should see the following

configGenScreenshot

Export workspace config

After adding the required sources and destinations, export your workspace config. This workspace-config is required by the RudderStack Server. To learn more about adding sources and destinations in RudderStack, refer Adding a Source and Destination in RudderStack

Update the config variables configFromFile and configJSONPath in rudder-server to read workspace config from the exported JSON file.

Start RudderStack with the workspace config file

  • Download the workspace config file on your machine.
  • In docker-compose.yml, uncomment volumes section under backend service. Specify the path to your workspace config.
  • In build/docker.env, set the environment variable RSERVER_BACKEND_CONFIG_CONFIG_FROM_FILE=true
  • Start RudderStack with docker-compose up

Export source configuration

After adding the required sources and destinations, export your source config for the sources. This source config is required by the RudderStack SDKs. After downloading the source config file, you need to host that file at a /sourceConfig end-point.

Then you can specify that link as your controlPlaneUrl while initializing the SDK.

More information

For more information and documentation related to the RudderStack Config Generator, check out our documentation.

We can make use of the addDestinationSource.js file in the src/scripts to generate the config code required automatically. Make use of the print functions to generate the code in the required format. Can alter the printConfig function to generate the config for either source/ destination. Can refer rudder stack webapp for more

Contact us

If you come across any issues while configuring or using the RudderStack Config Generator, please feel free to start a conversation on our Slack channel. We will be happy to help you.

config-generator's People

Contributors

ameypv-rudder avatar arnab-p avatar benedikt avatar dependabot[bot] avatar gmathieu avatar lokey avatar sampath-vi avatar shashank1992 avatar shekhar-rudder avatar shrouti1507 avatar snarkychef avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.