oct - GitLite

KO | EN

gitlite — search

#react #llm #go #android #deep-learning #macos #awesome #cli #vue #pytorch #security #ios #mcp #open-source

oct

(★ 104)

Testing cases and framework for OpenContainers project

파일 탐색기

최종 버전 다운로드 (.zip)

- Makefile
- - oct test flow.eddx
  - testflowchart.jpg
- dockerFactory.go
- factory.go
- rktFactory.go
- runcFactory.go
- runtimetest.go
- - .gitignore
- Godeps.json
- Readme
- Makefile
- - cases.conf
  - config.go
  - config_test.go
- - hook.go
  - poststart.go
- cmd.go
- file.go
- string.go
.gitignore
cases.conf
CONTRIBUTING.md
LICENSE
main.go
MAINTAINERS
Makefile
README.md
ROADMAP.md
rootfs.tar.gz
testunit.go

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/huawei-openlab/oct

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd oct

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## OCT - OCI Test 
      
The ocitest aims to test if a  container runtime is compliant with [opencontainers/specs](https://github.com/opencontainers/specs),     
It is a light weight testing framework, using ocitools and 3rd-party plugin tools, managing configurable high coverage bundles as cases, supporting testing different runtimes.

### Summary for the impatient      
***Key note***           
Be sure you have already installed  [golang](http://golang.org/) and the container runtime to be test, such as [runc](https://github.com/opencontainers/runc)  and [rkt](https://github.com/coreos/rkt) .

``` bash   
$ go get github.com/opencontainers/specs               #download specs of OCI
$ go get github.com/huawei-openlab/oct                 #get oct source code       
$ cd $GOPATH/src/github.com/huawei-openlab/oct         #change dir to workspace 
$ make                                                 #build      
$ ./ocitest                                            #run     
```

### OCI Test Quickstart       
       
####Usage 
       
``` sh      
$ ./ocitest --help
NAME:
   oci-testing - Utilities for OCI Testing,

It is a light weight testing framework,
    using ocitools and 3rd-party tools, 
    managing configurable high coverage bundles as cases, 
    supporting testing different runtimes.

USAGE:
   ./ocitest [global options] command [command options] [arguments...]
   
VERSION:
   0.0.1
   
COMMANDS:
   help, h  Shows a list of commands or help for one command
   
GLOBAL OPTIONS:
   --runtime,  -r   "runc"    runtime to be tested, -r=runc or -r=rkt or -r=docker     
   --output,    -o   "all"       format and content to be ouputed, -o=all: ouput sucessful details and statics, -o=err-only: ouput failure details and statics           
   --debug,    -d                  switch of debug mode, defaults to false, with '--debug' to enable debug mode     
   --help,       -h                  show help     
   --generate-bash-completion           
   --version,  -v                  print the version     
```    
      
####Supported runtime
      
|Name|Status|
|------|----|------|
| runc | Supported| 
| rkt | Supported |
| docker | Planning|
      
####Test Flow 
![testflow](https://raw.githubusercontent.com/huawei-openlab/oct/master/docs/static/testflowchart.jpg "testflow")

####Using Tools

Tools used by ocitest as plugins, including:

* [ocitools](http://github.com/zenlinTechnofreak/ocitools)

NOTE: ocitools are foked from [github.com/mrunalp](http://github.com/mrunalp/ocitools), added some adaptor changes for oct.

* [oci2aci](http://github.com/huawei-openlab/oci2aci)

See [plugins/Makefile](./plugins/Makefile)

####About Test Cases

Cases are listed in [cases.conf](./cases.conf), as the fomate of bunldes, It is going to be rich, in the fomate of below: 
    
```   
process= --args=./runtimetest --args=vp --rootfs=rootfs --terminal=false;--args=./runtimetest --args=vp --rootfs=rootfs --terminal=false     
# result to generate two cases in [bundle](./bundle), should be bundle/process0 and bundle/process1,        
# and '--args=./runtimetest --args=vp --rootfs=rootfs --terminal=false' is params for ocitools generate   
```

### Advantages of OCI Test       
1. Light weight testing freamwork      
2. High coverage test cases, configurable, easy to add cases
3. Tools are used as plugins ,feel free to use any 3rd-paty tools        
4. Uses goroutine, each go routine runs a case bundle to validate

### Next to Do

1. Rich cases:

Encrease the functionality of ocitools in [cmd/runtimetest](https://github.com/zenlinTechnofreak/ocitools/tree/master/cmd/runtimetest)   
   Rich cases in [cases.conf](./cases.conf)

2. Support other containers

### Reference
OCI specs on https://github.com/opencontainers/specs

OCI runc on https://github.com/opencontainers/runc