Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/couchbaselabs/sequoia
Scalable testing with containers
https://github.com/couchbaselabs/sequoia
docker orchestration scalability-tests
Last synced: 1 day ago
JSON representation
Scalable testing with containers
- Host: GitHub
- URL: https://github.com/couchbaselabs/sequoia
- Owner: couchbaselabs
- Created: 2016-02-18T18:19:16.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-12-12T08:31:49.000Z (16 days ago)
- Last Synced: 2024-12-12T09:30:46.117Z (16 days ago)
- Topics: docker, orchestration, scalability-tests
- Language: Python
- Homepage:
- Size: 17.1 MB
- Stars: 18
- Watchers: 64
- Forks: 13
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# sequoia
Scalable testing with docker
**Install Docker**
* Mac - https://docs.docker.com/mac/
* Ubuntu - https://docs.docker.com/engine/installation/linux/ubuntulinux/
* CentOS - https://docs.docker.com/engine/installation/linux/centos/
**Install Go (1.7+)**
* Ubuntu - https://github.com/golang/go/wiki/Ubuntu
* CentOS - http://itekblog.com/centos-golang/
* Any - https://golang.org/dl/
**Build**
```bash
cd $GOPATH/src/github.com/couchbaselabs/
git clone https://github.com/couchbaselabs/sequoia.git
cd sequoia
go mod init
go mod tidy
go build -o sequoia
```
## Getting Started
From the command-line:
```bash
# run simple test
./sequoia
# override the default test and scope
./sequoia -scope tests/simple/scope_medium.yml -test tests/simple/test_views.yml
```
### Running with a docker network (EXPERIMENTAL)
```
./sequoia -scope tests/simple/scope_medium.yml -test tests/simple/test_views.yml --network cbl
```
Refer to [Test Syntax](https://github.com/couchbaselabs/sequoia/wiki/Test-Syntax) for more information about how to build out your test and scopes.
## Client
Sequoia works by running containers that apply load to couchbase servers. These containers are running on docker specified by the client in your config file. Depending on your docker install you will need to use http(s) and specify port. It's recommended to run over a tcp port.
```yaml
# config.yml
...
client: https://192.168.99.100:2376
```
Or on server without https and daemon running on port 2375
```yams
# config.yml
...
client: http://172.23.97.124:2375
```
## Providers
Providers help decouple test and provisioning from the mechanisms that provide couchbase resources so that the same scope can present an identical environment to different tests. You can change your provider via the config file.
```yaml
# config.yml
...
provider: docker # dev, file
```
Read More about [Providers Here](https://github.com/couchbaselabs/sequoia/wiki/Providers)