shard

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 20, 2023 License: Apache-2.0 Imports: 6 Imported by: 0

README

Shard Wrapper

The shard wrapper is a way of sharding calls based on metadata key-value so requests can be pinned to a particular backend node.

For example if you want to use session affinity aka sticky sessions you can specify the header value for sessions e.g. X-From-Session or X-From-User

X-From-Session or X-From-User is likely a unique session token or user id. The shard wrapper will look for the key you specify and use the crc32 checksum of the value against the nodes much like the gomemcache library. It uses a selector strategy to achieve this.

Usage

Pass in the wrapper when you create your service with the key you want to shard on

wrapper := shard.NewClientWrapper("X-From-Session")

service := micro.NewService(
	micro.Name("foo"),
	micro.WrapClient(wrapper),
)

Alternatively wrap the client and use independently

wrapper := shard.NewClientWrapper("X-From-Session")

client := wrapper(service.Client())

Documentation

Overview

Package shard implements the sharding call strategy

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func NewClientWrapper

func NewClientWrapper(key string) client.Wrapper

NewClientWrapper is a wrapper which shards based on a header key value

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL