Products

English

English

Pipy Documentation

Introduction

Overview
Concepts

Getting Started

Build and Install
Quick Start
Getting help

Release

Release History

0.10.0-1
0.22.0-31
0.30.0
0.50.0

Tutorial

Part 1: Hello
Part 2: Echo
Part 3: Proxy
Part 4: Routing
Part 5: Loading Balancing
Part 6: Configuration
Part 7: Plugins

Operating

Admin GUI
CLI
Pipy Repo

Introduction
Quick Start
Demo
REST API

Statistics

Reference

API

Configuration

Data

from()
Data()
push()
shift()
shiftTo()
shiftWhile()
size
toArray()

Hessian

decode()
encode()

JSON

decode()
encode()
parse()
stringify()

Message

body
head
Message()
tail

MessageEnd

MessageEnd()
payload
tail

MessageStart

head
MessageStart()

Netmask

base
bitmask
broadcast
contains()
decompose()
first
hostmask
ip
last
mask
Netmask()
next()
size
version

StreamEnd

error
StreamEnd()

URL

auth
hash
host
hostname
href
URL()
origin
password
path
pathname
port
protocol
query
search
searchParams
username

URLSearchParams

get()
getAll()
URLSearchParams()
set()
toObject()

XML

Node

attributes
children
name
Node()

decode()
encode()
parse()
stringify()

algo

Cache

clear()
get()
Cache()
remove()
set()

HashingLoadBalancer

add()
HashingLoadBalancer()
next()

LeastWorkLoadBalancer

LeastWorkLoadBalancer()
next()
set()

Quota

consume()
current
initial
Quota()
produce()
reset()

RoundRobinLoadBalancer

RoundRobinLoadBalancer()
next()
set()

URLRouter

add()
find()
URLRouter()

hash()
uuid()

console

debug()
error()
info()
log()
warn()

crypto

Certificate

issuer
Certificate()
subject
subjectAltNames

CertificateChain

CertificateChain()

Cipher

final()
Cipher()
update()

Decipher

final()
Decipher()
update()

Hash

digest()
Hash()
update()

Hmac

digest()
Hmac()
update()

JWK

isValid
JWK()

JWT

header
isValid
JWT()
payload
verify()

PrivateKey

PrivateKey()

PublicKey

PublicKey()

Sign

Sign()
sign()
update()

Verify

Verify()
update()
verify()

http

Agent

new()
request()

Directory

new()
serve()

logging

BinaryLogger

log()
BinaryLogger()
toFile()
toHTTP()
toStderr()
toStdout()
toSyslog()

JSONLogger

log()
JSONLogger()
toFile()
toHTTP()
toStderr()
toStdout()
toSyslog()

TextLogger

log()
TextLogger()
toFile()
toHTTP()
toStderr()
toStdout()
toSyslog()

os

env
readDir()
readFile()
stat()
unlink()
writeFile()

pipy()

exit()
load()
restart()
solve()

stats

Counter

decrease()
increase()
Counter()
withLabels()
zero()

Gauge

decrease()
increase()
Gauge()
set()
withLabels()
zero()

Histogram

Histogram()
observe()
withLabels()
zero()

PipyJS

Language
Builtin Objects
NMI

Build and Install

Build from Sources

Before building, the following prerequisites are required to be installed on your machine where you will be building Pipy:

Clang 5.0+
CMake 3.0+
Node.js v12+ (only required if the builtin web UI is enabled)
zlib

With the above, all installed, Pipy repository cloned, run the build script from Pipy root directory to start building:

$ git clone https://github.com/flomesh-io/pipy.git
$ cd pipy
$ ./build.sh

The final executable product will be located under bin/. Type bin/pipy -h for help information.

Build a Docker Image

To build a Docker image, run the following commands:

$ cd pipy
$ docker build --squash --rm -t pipy .

Note: For a smaller image, you might want to use --squash option. It is an experimental feature, so you need to add { "experimental": true } to /etc/docker/daemon.json and restart Docker daemon before using it.
For more information about Docker's --squash option, please refer to Docker Documentation

Install with RPM

On Linux based system, you can install from the released rpm package. For example, to install pipy on RHEL7 you can invoke

$ yum -y install http://repo.flomesh.cn/pipy/pipy-latest.el7_pl.x86_64.rpm

Build from Sources

Build a Docker Image

Install with RPM

Products

© 2024, Flomesh Team. ICP备案/许可证号：辽ICP备2023014827号