Giter VIP home page Giter VIP logo

components-contrib's Introduction

Any language, any framework, anywhere

Go Report OpenSSF Docker Pulls Build Status Test Status Code Coverage License: Apache 2.0 FOSSA Status TODOs Good First Issues discord YouTube X/Twitter

Dapr is a portable, serverless, event-driven runtime that makes it easy for developers to build resilient, stateless and stateful microservices that run on the cloud and edge and embraces the diversity of languages and developer frameworks.

Dapr codifies the best practices for building microservice applications into open, independent, building blocks that enable you to build portable applications with the language and framework of your choice. Each building block is independent and you can use one, some, or all of them in your application.

Dapr overview

We are a Cloud Native Computing Foundation (CNCF) incubation project.

Goals

  • Enable developers using any language or framework to write distributed applications
  • Solve the hard problems developers face building microservice applications by providing best practice building blocks
  • Be community driven, open and vendor neutral
  • Gain new contributors
  • Provide consistency and portability through open APIs
  • Be platform agnostic across cloud and edge
  • Embrace extensibility and provide pluggable components without vendor lock-in
  • Enable IoT and edge scenarios by being highly performant and lightweight
  • Be incrementally adoptable from existing code, with no runtime dependency

How it works

Dapr injects a side-car (container or process) to each compute unit. The side-car interacts with event triggers and communicates with the compute unit via standard HTTP or gRPC protocols. This enables Dapr to support all existing and future programming languages without requiring you to import frameworks or libraries.

Dapr offers built-in state management, reliable messaging (at least once delivery), triggers and bindings through standard HTTP verbs or gRPC interfaces. This allows you to write stateless, stateful and actor-like services following the same programming paradigm. You can freely choose consistency model, threading model and message delivery patterns.

Dapr runs natively on Kubernetes, as a self hosted binary on your machine, on an IoT device, or as a container that can be injected into any system, in the cloud or on-premises.

Dapr uses pluggable component state stores and message buses such as Redis as well as gRPC to offer a wide range of communication methods, including direct dapr-to-dapr using gRPC and async Pub-Sub with guaranteed delivery and at-least-once semantics.

Why Dapr?

Writing highly performant, scalable and reliable distributed application is hard. Dapr brings proven patterns and practices to you. It unifies event-driven and actors semantics into a simple, consistent programming model. It supports all programming languages without framework lock-in. You are not exposed to low-level primitives such as threading, concurrency control, partitioning and scaling. Instead, you can write your code by implementing a simple web server using familiar web frameworks of your choice.

Dapr is flexible in threading and state consistency models. You can leverage multi-threading if you choose to, and you can choose among different consistency models. This flexibility enables you to implement advanced scenarios without artificial constraints. Dapr is unique because you can transition seamlessly between platforms and underlying implementations without rewriting your code.

Features

  • Event-driven Pub-Sub system with pluggable providers and at-least-once semantics
  • Input and output bindings with pluggable providers
  • State management with pluggable data stores
  • Consistent service-to-service discovery and invocation
  • Opt-in stateful models: Strong/Eventual consistency, First-write/Last-write wins
  • Cross platform virtual actors
  • Secret management to retrieve secrets from secure key vaults
  • Rate limiting
  • Built-in Observability support
  • Runs natively on Kubernetes using a dedicated Operator and CRDs
  • Supports all programming languages via HTTP and gRPC
  • Multi-Cloud, open components (bindings, pub-sub, state) from Azure, AWS, GCP
  • Runs anywhere, as a process or containerized
  • Lightweight (58MB binary, 4MB physical memory)
  • Runs as a sidecar - removes the need for special SDKs or libraries
  • Dedicated CLI - developer friendly experience with easy debugging
  • Clients for Java, .NET Core, Go, Javascript, Python, Rust and C++

Get Started using Dapr

See our Getting Started guide over in our docs.

Quickstarts and Samples

Community

We want your contributions and suggestions! One of the easiest ways to contribute is to participate in discussions on the mailing list, chat on IM or the bi-weekly community calls. For more information on the community engagement, developer and contributing guidelines and more, head over to the Dapr community repo.

Contact Us

Reach out with any questions you may have and we'll make sure to answer them as soon as possible!

Platform Link
๐Ÿ’ฌ Instant Message Chat (preferred) Discord Banner
๐Ÿ“ง Mailing List https://groups.google.com/forum/#!forum/dapr-dev
๐Ÿค Twitter @daprdev

Community Call

Every two weeks we host a community call to showcase new features, review upcoming milestones, and engage in a Q&A. All are welcome!

๐Ÿ“ž Visit https://aka.ms/dapr-community-call for upcoming dates and the meeting link.

Videos and Podcasts

We have a variety of keynotes, podcasts, and presentations available to reference and learn from.

๐Ÿ“บ Visit https://docs.dapr.io/contributing/presentations/ for previous talks and slide decks.

Contributing to Dapr

See the Development Guide to get started with building and developing.

Repositories

Repo Description
Dapr The main repository that you are currently in. Contains the Dapr runtime code and overview documentation.
CLI The Dapr CLI allows you to setup Dapr on your local dev machine or on a Kubernetes cluster, provides debugging support, launches and manages Dapr instances.
Docs The documentation for Dapr.
Quickstarts This repository contains a series of simple code samples that highlight the main Dapr capabilities.
Samples This repository holds community maintained samples for various Dapr use cases.
Components-contrib The purpose of components contrib is to provide open, community driven reusable components for building distributed applications.
Dashboard General purpose dashboard for Dapr
Go-sdk Dapr SDK for Go
Java-sdk Dapr SDK for Java
JS-sdk Dapr SDK for JavaScript
Python-sdk Dapr SDK for Python
Dotnet-sdk Dapr SDK for .NET
Rust-sdk Dapr SDK for Rust
Cpp-sdk Dapr SDK for C++
PHP-sdk Dapr SDK for PHP

Code of Conduct

Please refer to our Dapr Community Code of Conduct

components-contrib's People

Contributors

1046102779 avatar addjuarez avatar akhilac1 avatar amimimor avatar artursouza avatar berndverst avatar cmendible avatar codemonkeyleet avatar daixiang0 avatar dapr-bot avatar deepanshua avatar dmitsh avatar halspang avatar italypaleale avatar jarema avatar jjcollinge avatar joshvanl avatar mchmarny avatar mukundansundar avatar pkedy avatar pravinpushkar avatar robertojrojas avatar ryanlettieri avatar shalabhms avatar shivamkm07 avatar shubham1172 avatar taction avatar tmacam avatar yaron2 avatar youngbupark avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

components-contrib's Issues

Cassandra state store

Describe the proposal

Implement Cassandra as a state store and transactional state store.

Add transactions support to MongoDB

Describe the proposal

Implement the Transactions interface for MongoDB.
That would make MondoDB be able to operate multi-operation transactions and be certified for an Actor state store for Dapr.

Checking wrong metadata value when setting AutoDeleteOnIdleInSec

Expected Behavior

When the a.metadata.AutoDeleteOnIdleInSec is not nil we can set the configuration setting on the subscription.

Actual Behavior

The wrong metadata setting i.e. a.metadata.DefaultMessageTimeToLiveInSec is checked instead so it'll incorrectly try to set AutoDeleteOnIdleInSec even if it was nil in the metadata.

Sorry this was my bad - didn't catch it before merge of my PR for issue #93

Azure Service Bus Topics

Hello,

Is there a way to subscribe to a topic? I have tried the sample and can connect to a queue successfully but not to a topic (even with the /dapr/subscriptions endpoint added):

https://github.com/dapr/docs/blob/master/concepts/bindings/specs/servicebusqueues.md

Also I traced the http response and can't seem to get the message properties from the service bus message, just the content. I would like at least to get the CorrelationId from the message headers if that is supported? Thanks

Add GCP KMS as a secrets store

Describe the proposal

Add support for GCP KMS as a Secrets Store.

The means to authenticate with GCP resources can be found in other components like GCP Pub/Sub, and the way these get passed in can be inferred from the other secrets store implementations.

Change redispipe package to go-redis for state management

Describe the proposal

The go-redis package is a common and highly used package for interacting with Redis for Go. It's used by Redis for Pub/Sub, while the Redis State Store uses redispipe, which favors implicit pipelining but does not support things like TLS.

I propose to standardize on go-redis as the package for Redis interactions in components-contrib.

Extend Kafka binding metadata configuration

For various Bindings, client should have way to get configuration settings from the metadata.
E.g. For Kafka bindings, following producer configs are not configurable.
Required Acks
Maximum Retry

[Question] Pubsub semantics

Ask your question here

As per pubsub docs "Dapr guarantees At-Least-Once semantics for message delivery". Does this imply that means that pubsub component does not depend on the underlying messaging implementation semantics? e.g. if the "implementation A" supports (or is configured to support) "at-most-once" (no duplicates), Dapr might still end up re-trying and sending duplicate messages?

Let me know if this is posted/detailed elsewhere

Add metadata to State Delete and Get requests

Describe the proposal

Currently custom metadata to a state store implementation is only supported through a SetRequest.

This proposes to add passing metadata with GetRequest and DeleteRequest also.

Review and improve the Component contrib guidelines

Improved with

  1. YAML spec needs to be included
  2. Merge can only occur after all Tasks completed
  3. Review the contribute proposal template for all the task
  4. Make sure that you assign the issues to yourself to indicate you are working on this

Add Etcd as a supported state

Describe the proposal

Etcd is a distributed key-value store with features comparable to Redis.
I propose adding Etcd as another state option for Dapr.

TLS config for Redis client

Describe the proposal

Hello, I'm trying to use Dapr with Digital Ocean managed Redis which is using secured connection. I'm getting following message:

time="2019-11-02T17:45:45Z" level=warning msg="error initializing pub sub pubsub.redis: redis streams: error connecting to redis at private-dapr01-do-user-2603541-0.db.ondigitalocean.com:25061: EOF"

I suspect it is caused by the missing TLS configuration here:

https://github.com/dapr/components-contrib/blob/master/pubsub/redis/redis.go#L69

	client := redis.NewClient(&redis.Options{
		Addr:            m.host,
		Password:        m.password,
		DB:              0,
		MaxRetries:      3,
		MaxRetryBackoff: time.Second * 2,
	})

Could you confirm or refute whether the current implementation of Redis pub sub supports secure connection?

Thanks in advance!

[Question] How to dev a new bindings and test

Ask your question here

I just saw this

Implementing a new binding
A compliant binding needs to implement one or more interfaces, depending on the type of binding (Input or Output):

Input binding:

type InputBinding interface {
	Init(metadata Metadata) error
	Read(handler func(*ReadResponse) error) error
}
Output binding:

type OutputBinding interface {
	Init(metadata Metadata) error
	Write(req *WriteRequest) error
}

And how to test?
Thanks!

Azure Service Bus pubsub implementation

Azure ServiceBus PubSub

Add an Azure ServiceBus PubSub implementation. Opening this as a reference issue for an incoming PR. Proposal is fairly self explanatory.

Thought it might be useful to some folks to use a hosted message bus for pubsub rather than redis or the newly added NATS implementation. Apologies I didn't open this sooner to discuss, if we don't think this is a good idea then no problem!

Related: #73
PR: #93

Add transactions support to Cassandra

Describe the proposal

Implement the Transactions interface for Cassandra.
That would make Cassandra be able to operate multi-operation transactions and be certified for an Actor state store for Dapr.

Rename package name?

Describe the proposal

now the name is components-contrib, but it's too long.
I suggest that rename to common or base or components, ok?
thanks!

Add AWS SecretManager as secret-store

Describe the proposal

Add support for AWS Secret Manager as a Secrets Store.

The means to authenticate with AWS resources can be found in other components like SQS, and the way these get passed in can be inferred from the other secrets store implementations.

Error while running `go mod tidy`

Expected Behavior

No error for go mod tidy

Actual Behavior

The below error is happening

github.com/dapr/dapr/pkg/components/bindings imports
        github.com/dapr/components-contrib/bindings/kubernetes imports
        github.com/kubernetes-client/go/kubernetes/config tested by
        github.com/kubernetes-client/go/kubernetes/config.test imports
        k8s.io/client/kubernetes/config/api: git ls-remote -q https://github.com/kubernetes/client in /Users/XXX/go/pkg/mod/cache/vcs/1873572271fcf325ad32062ccf6aee165fdb6b2229b714b40050d6bf3d599824: exit status 128:
        remote: Repository not found.
        fatal: repository 'https://github.com/kubernetes/client/' not found
$๎‚ฐ go version
go version go1.13.3 darwin/amd64

Steps to Reproduce the Problem

Just run go mod tidy

Enhance Kafka bindings to support SASL auth

Describe the proposal

Kafka brokers can be configured to support SASL authentication. The Dapr Kafka binding can be enhanced to provide this. This will allow integration with any Kafka broker including managed ones (where auth is mandatory) such as Azure Event Hubs, Confluent etc.

This authentication is optional and can be disabled using Dapr config e.g. authRequired: "false"

Cassandra state store should allow user defined port

Expected Behavior

Cassandra state store should allow user-defined port

Actual Behavior

gocql driver connects to port 9042 by default

Steps to Reproduce the Problem

start a cassandra instance on port other than the default one (9042) and run any app along side Dapr. You should see connection related error logs

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.