Home / Golang / Distributed Systems

Inspr is an application mesh for simple, fast and secure development of distributed applications.

Inspr is an engine for running distributed applications, using multiple communication patterns such as pub sub and more, focused on type consistency and development simplicity.
Information
Category: Golang / Distributed Systems
Watchers: 3
Star: 25
Fork: 2
Last update: Apr 20, 2021
Resource links
https://inspr.com
https://github.com/inspr/inspr

Inspr is an engine for running distributed applications, using multiple communication patterns such as pub sub and more, focused on type consistency and development simplicity.

  • 💪 Robust: built on top of golang, kubernetes and other state of the art technologies
  • ✨ Distributed: created to allow complex and hierarchical distributed design patterns
  • ☁️ Cloud native: lightweight and modular, built with interchangeable pieces
  • 🛠️ Versatile: can adapt to any cloud environment

Table of Contents

🎉 Getting Started

Cluster

The recommended way to install inspr in a kubernetes cluster is by using helm.

the first step is add the helm chart repository to the cluster:

helm repo add inspr https://inspr-charts.storage.googleapis.com

Then install inspr with the command:

helm install inspr_name inspr/insprd

replacing inspr_name by the desired inspr cluster name.

Aditionaly you can check the default values file for the helm chart. They are included in the build/helm folder and can be edited for further refinement of the properties.

CLI

To install the CLI get the latest release for your architecture from the releases page and add it to your PATH. TODO: Add link to the install script for the CLI.

Documentation

The full documentation for Inspr can be found on our website. The source for the Inspr documentation and website is hosted on a separate repo, @inspr/docs.

Architecture

  • TBD

👏 Contributing

The main purpose of this repository is to continue evolving Inspr core. We want to make contributing to this project as easy and transparent as possible, and we are grateful to the community for contributing bug fixes and improvements. To contribute, please check out our guide.

📄 License

  • Inspr is licenced under MIT license.
  • Inspr documentation is Creative Commons licensed, as found in the license-docs file.

📣 Contact

To contact us, please join our Discord community. Aditionally we are at Reddit

9 Open More issues
Closed

Update networking from to v1, update k8s.io libs to v020.6

Description

The extensions/v1beta1 and networking.k8s.io/v1beta1 API versions of Ingress was deprecated and will no longer be served in v1.22. This PR apply the requested fixes, described at:

https://kubernetes.io/docs/reference/using-api/deprecation-guide/

Notable changes:

  • spec.backend is renamed to spec.defaultBackend
  • The backend serviceName field is renamed to service.name
  • Numeric backend servicePort fields are renamed to service.port.number
  • String backend servicePort fields are renamed to service.port.name
  • pathType is now required for each specified path. Options are Prefix, Exact, and ImplementationSpecific. To match the undefined v1beta1 behavior, use ImplementationSpecific.

We also use use an older version of k8s.io libraries, this PR updates to v20.6

Kind: Upgrade Section: Helm Summary: - Issue link: -

Changelog

Helm charts for insprd, auth and ui provider

Pay attention to

Check if the ingress works as expected, I've run the tests locally and seems to be all fine.

Important parts of the code that require special attention

Ingress now has two options for port, numeric and string looking our config I've choose to use numeric, but it can be an issue if we support string defined ports

documentation enhancement help wanted experimental 
opened Apr 24, 2021 by brenordr 13
Closed

Helm chart rework and new features

Description

Kind: feature

Section: helm chart

Summary: changes helm chart completely and adds a full-stack helm chart with initialization

Changelog

Deletes old helm chart Creates new helm chart with more configurations Creates full helm chart with automatic uidp initialization support

Pay attention to

Did not adapt CI scripts Overrides file needs to change

build controller 
opened Jul 12, 2021 by ptcar2009 3
Closed

DRAFT: fix(docs): move documentation to inspr/docs

We are moving the docs to github.com/inspr/docs

documentation 
opened Apr 28, 2021 by brenordr 3
Closed

Kubernetes config for k8s doesn't use helm

The port, host and a few other values are hard coded for k8s configs at ./build/k8s @ptcar2009 I'm not sure if this file is used, but if it is should we consider move it to a helm chart?

good first issue 
opened Apr 24, 2021 by brenordr 3
Closed

Draft: TASK CORE-360 | Update go mod path to inspr.dev/inspr vanity URL

Description

Kind: Ehancement

Section: *

Summary: Update go mod path to inspr.dev/inspr

Issue link: #18
Jira Link: https://inspr.atlassian.net/browse/CORE-360

Changelog

List the main points of change

Pay attention to

Project imports, check if builds correctly

Important parts of the code that require special attention

documentation enhancement insprd api 
opened Apr 17, 2021 by brenordr 3
Closed

Move project to a vanity import path

Is your feature request related to a problem? Please describe. Recently we moved the project to github. But to conclude the migration we should update the imports not to github.com/inspr/inspr but to inspr.io/inspr, inspr.dev/inspr, inspr.dev/x, inspr.dev/v1 or something along those lines.

Describe the solution you'd like Use the path inspr.io/x/ or inspr.dev/x/ I prefer the .dev with x but we can choose any of them

Describe alternatives you've considered We can keep just the github but in some sense it can be a problem for people using the product. for example if we need to move the repos.

Additional context Some references:

https://sagikazarmark.hu/blog/vanity-import-paths-in-go/ https://medium.com/@JonNRb/making-a-golang-vanity-url-f56d8eec5f6c

The process can be very simple. Google prepared a tool for it: https://github.com/GoogleCloudPlatform/govanityurls We need to put it as an dapp in our cluster and expose it as a service, then point inspr.io or inspr.dev to the correct path.

enhancement 
opened Apr 17, 2021 by brenordr 3
Open

Thoughts: should port be a uint16 or at least an int32?

https://github.com/inspr/inspr/blob/870bb13b4eb60653c8567dd8a70ccdfa69e1391b/pkg/meta/dapp.go#L13

TCP /UDP ports range from 0 to 2^16 https://en.wikipedia.org/wiki/Port_(computer_networking)

In many places we parse this port and convert to int32

e.g:

https://github.com/inspr/inspr/blob/870bb13b4eb60653c8567dd8a70ccdfa69e1391b/cmd/insprd/operators/nodes/converter.go#L29 and https://github.com/inspr/inspr/blob/870bb13b4eb60653c8567dd8a70ccdfa69e1391b/cmd/insprd/operators/nodes/converter.go#L43

An overflow here can cause undefined behavior to the application.

help wanted question 
opened Nov 11, 2021 by brenordr 2
Open

Fix/codeql

Description

Kind:

Add security fixes for #160 and #159

Section:

authsvc and insprd have been updated in this PR

for authsvc the bitsize was lift to 2048 bits

for insprd added a check to the port size to be a guaranteed TCP / UDP port

Summary:

Changelog

List the main points of change

Pay attention to

Important parts of the code that require special attention

Need to add changelog before merge :)

opened Nov 11, 2021 by brenordr 1
Open

Install script failing on MacOS

What happened:

macos seems to return i386 to the command uname -p and this in turn makes the script exit with message: There is no i386 binary for darwin OS.

Checking https://unix.stackexchange.com/questions/518318/what-does-i386-mean-on-macos-mojave/518350 seems that uname -p for macos will return i386 to all macs that run on intel even for the ones with 64bit

What you expected to happen:

Should install the CLI

How to reproduce it (as minimally and precisely as possible):

run the install script on a computer running macos

Anything else we need to know?:

The following script fix the issue and work well.

  • Tested on macos Monterey
  • the following script also fix the binary name to insprctl
#!/bin/bash

CLI_VERSION=$(curl -s https://storage.googleapis.com/inspr-cli/latest-version)
CURL_URL="https://storage.googleapis.com/inspr-cli/${CLI_VERSION}/insprcli"

OS_NAME=$(uname -s)
echo 'Your operating system is '$OS_NAME

case "${OS_NAME}" in
    Linux*)     CURL_URL=$CURL_URL"-linux";;
    Darwin*)    CURL_URL=$CURL_URL"-darwin";;
    CYGWIN* | MINGW* | Windows*)
        echo "For windows system trying to run the bash script, please download the executable from the release page"
        exit 1
    ;;
    *)          
        echo "ERROR identifying the os"
        exit 1
    ;;
esac

# For macos check the machine type instead of arch only
if [[ $OS_NAME == Darwin* ]]; then
    ARCH=$(uname -m)
else
    ARCH=$(uname -p)
fi

echo 'Your computer architecture is '$ARCH

case "${ARCH}" in
    x86_64* | amd64*) 
        CURL_URL=$CURL_URL"-amd64"
    ;;
    
    i*86)
        if [[ $OS_NAME == Darwin* ]]; then
            echo 'There is no i386 binary for darwin OS.'
            exit 2
        else
            CURL_URL=$CURL_URL"-386"
        fi
    ;;
    
    arm) 
        # in the repo there is no arm binary for systems other than Linux
        if [[ $OS_NAME == Darwin* ]]; then
            CURL_URL=$CURL_URL"-arm64"
        else
            CURL_URL=$CURL_URL"-arm"
        fi
    ;;

    arm* | aarch64) 
        CURL_URL=$CURL_URL"-arm64"
    ;;
    
    *)  
        echo "ERROR identifying the architecture"
        exit 2
    ;;
esac

# adding the version to the curl URL
CURL_URL=$CURL_URL"-"$CLI_VERSION

echo 'Downloading the inspr cli binary'
curl $CURL_URL -o /tmp/insprctl

ENCODING=utf-8
if iconv --from-code="$ENCODING" --to-code="$ENCODING" /tmp/insprctl > /dev/null 2>&1; then
    echo "error, coudln't find the binary, in the url used"
    echo $CURL_URL
else    
    chmod +x /tmp/insprctl 
    echo 'Moving binary into /usr/local/bin, need sudo permission'
    sudo mv /tmp/insprctl /usr/local/bin
    echo 'Files moved to to /usr/local/bin'
fi
opened Nov 11, 2021 by brenordr 0
Open

Fix code scanning alert - Use of a weak cryptographic key

Tracking issue for:

  • [ ] https://github.com/inspr/inspr/security/code-scanning/28
opened Nov 11, 2021 by brenordr 0
Open

Fix code scanning alert - Incorrect conversion between integer types

Tracking issue for:

  • [ ] https://github.com/inspr/inspr/security/code-scanning/15
opened Nov 11, 2021 by brenordr 0
Open

Inspr daemon doesn't work with more than a replica in kubernetes

Is your feature request related to a problem? Please describe. Since the daemon works with a tree structure in memory, when deploying more than a replica there will be conflict between the states of each instance. Also if the pod fails for any reason the memory of the pod could be lost and the tree structure gone.

Describe the solution you'd like Implement the tree Interface but interacting with a database

Describe alternatives you've considered Any database will solve the problem, SQL, NoSQL or even something like Redis. This would have an implication on the helm chart since it requires the database/store to exist.

Additional context Add any other context or screenshots about the feature request here.

enhancement critical 
opened Nov 5, 2021 by nicholaspcr 8

Contents

    asny tri-mesh - A triangle mesh data structure including basic operations
    anup-a 🧞‍♂️ MESH·Y is a design tool to generate beautiful & colorful mesh gradients.
    VastidDev A repo that contains all the mesh keys needed for mesh backend, along with a code example of how to use them in python
    pmp-library The Polygon Mesh Processing Library
    JacksonHoggard 👹 2D Java game engine built in Java
    KunalMGupta Neural Mesh Flow: 3D Manifold Mesh Generation via Diffeomorphic Flows
    substack refine a 2d mesh by splitting edges longer than a maximum length
    chmike Fast, secure and efficient secure cookie encoder/decoder
    HarvsG A text repo to feature-track all the WireGuard mesh software
    cerndb Distributed Deep Learning, with a focus on distributed training, using Keras and Apache Spark.
    createthis Mesh Maker VR
    Microsoft Service Fabric is a distributed systems platform for packaging, deploying, and managing stateless and stateful distributed applications and containers at large scale.
    tensorflow Mesh TensorFlow: Model Parallelism Made Easier
    keijiro A Unity example showing how to modify vertex positions and recalculate normals of an animating skinned mesh.
    chrispsn Visualise data and edit JavaScript code using a spreadsheet interface.
    solo-io The Service Mesh Orchestration Platform
    meshery Meshery Adapter for Cilium Service Mesh
    cilium Instructions and issue tracking for Service Mesh capabilities of Cilium
    syoyo Tiny Mesh utilities(e.g. compute half-edge data structure) in C++11
    layer5io Incorporate Service Mesh Patterns into your GitHub workflows using Meshery's CLI
    jitsi Jitsi Meet - Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.
    Share this repo

    Related Repos


    Distributed Systems
    22
    Template repository to work on the labs from MIT 6.824 Distributed Systems course.
    arindas MIT 6.824 Distributed Systems Labs and related materials from the MIT 6.824 Distributed Systems course. This repository will contain no solutions as r
     
    Distributed Systems
    6.6k
    DTM is lightweight distributed transaction management service, support xa tcc saga
    dtm-labs DTM is the first golang open source distributed transaction project. It elegantly resolve the problem of execution out of order. In the microservice architecture, a high-performance and easy-to-use distributed transaction solution is provided.
     
    Distributed Systems
    1.5k
    Zadig is an open-source, distributed, cloud-native CD (Continuous Delivery) product design...
    koderover Zadig is an open-source, distributed, cloud-native CD (Continuous Delivery) product designed for developers. Zadig not only provides high-availability CI/CD capabilities, but also provides cloud-native operating environments, supports developers' local debugging, parallel build and deployment of microservices, integration testing, etc. .
     
    Distributed Systems
    11
    Nebula Operator manages NebulaGraph clusters on Kubernetes and automates tasks related to ...
    vesoft-inc Nebula Operator manages NebulaGraph clusters on Kubernetes and automates tasks related to operating a NebulaGraph cluster. It evolved from NebulaGraph Cloud Service, makes NebulaGraph a truly cloud-native database.
     
    Distributed Systems
    25
    Inspr is an application mesh for simple, fast and secure development of distributed applic...
    inspr Inspr is an engine for running distributed applications, using multiple communication patterns such as pub sub and more, focused on type consistency and development simplicity.
     
    Distributed Systems
    3k
    Encore - Go framework for building distributed systems
    encoredev Encore is a Go backend framework for rapidly creating APIs and distributed systems.
     
    Distributed Systems
    2.3k
    Lotus is an implementation of the Filecoin Distributed Storage Network.
    filecoin-project Lotus is an implementation of the Filecoin Distributed Storage Network. For more details about Filecoin, check out the Filecoin Spec.
     
    Distributed Systems
    4.9k
    💡 A Distributed and High-Performance Monitoring System
    ccfos 💡 A Distributed and High-Performance Monitoring System
     
    Distributed Systems
    505
    📕 twtxt is a Self-Hosted, Twitter™-like Decentralised microBlogging platform
    jointwt 📕 twtxt is a Self-Hosted, Twitter™-like Decentralised microBlogging platform. No ads, no tracking, your content, your data!
     
    Distributed Systems
    367
    OpenYurt - Extending your native Kubernetes to edge
    alibaba OpenYurt is built based on native Kubernetes and targets to extend it to support edge computing seamlessly. In a nutshell, OpenYurt enables users to manage applications that run in the edge infrastructure as if they were running in the cloud infrastructure.
     
    Distributed Systems
    162
    🔥 Kubernetes multi-cluster deployment automation service.
    Clivern 🔥 Kubernetes multi-cluster deployment automation service.
     
    Distributed Systems
    230
    Lockgate is a cross-platform locking library for go with distributed locks support using K...
    werf Lockgate is a cross-platform locking library for go with distributed locks support using Kubernetes and OS file locks support
     
    Featured
    Distributed Systems
    3.5k
    Distributed RTC System by pure Go and Flutter
    pion ION is a distributed real-time communication system, the goal is to chat anydevice, anytime, anywhere! Architecture Modules Name Information
     
    Popular
    Distributed Systems
    4.2k
    M3 monorepo - Distributed TSDB, Aggregator and Query Engine, Prometheus Sidecar, Graphite ...
    m3db M3 Distributed TSDB and Query Engine, Prometheus Sidecar, Metrics Aggregator, and more. "More" now includes Graphite storage and query engine! More information: Documentation Developer: Getting Started Slack Foru
     
    Distributed Systems
    42
    A distributed service for monotonically increasing tickets.
    tidwall A distributed service for monotonically increasing tickets