Skip to content

Commit

Permalink
Updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Boris Sekachev committed Nov 2, 2018
1 parent bea7ce2 commit 575f181
Show file tree
Hide file tree
Showing 3 changed files with 57 additions and 1 deletion.
3 changes: 2 additions & 1 deletion components/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,5 @@
* [OpenVINO](openvino/README.md)
* [Tensorflow Object Detector](tf_annotation/README.md)
* [Analytics](analytics/README.md)
* [SSH](analytics/README.md)
* [SSH](ssh/README.md)
* [Git Integration](git/README.md)
36 changes: 36 additions & 0 deletions components/git/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
## Git Integration For Annotation Storage

### Description

Component allows to integrate any git repository with CVAT task for annotation storage.
Application supports github or gitlab repositories (include custom gitlab servers).
Application uses the specified git user for work with remote repositories and SSH protocol for authorization.

### Installation

* Setup variables ```CVAT_HEADLESS_USERNAME``` and ```CVAT_HEADLESS_EMAIL``` in the docker-compose.git.yml.
* Put private SSH key for this user into ```components/ssh/keys```. Public key corresponding to this private key should be attached to used github user.
* Build CVAT image with SSH and GIT application as listed below.
* Setup your repository URL in create task dialog. You can change a attached repository later.
* Annotate a task.
* Press button "Git Repository Sync" at dashboard.
* In dialog window press button "Push" and waiting some time.
* Annotation will be dumped, archived and pushed to ```cvat_username``` branch of remote repository.


### Dependencies

* SSH component with predefined valid ssh keys for the Git user.


### Build docker image
```bash
# From project root directory
docker-compose -f docker-compose.yml -f components/ssh/docker-compose.ssh.yml -f components/git/docker-compose.git.yml build
```

### Run docker container
```bash
# From project root directory
docker-compose -f docker-compose.yml -f components/ssh/docker-compose.ssh.yml -f components/git/docker-compose.git.yml up -d
```
19 changes: 19 additions & 0 deletions components/ssh/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
## Custom SSH Keys

### Description

If you need add custom SSH keys to your CVAT image, you can use this component.
Just put your keys to ```components/ssh/keys``` dir and them will be copied to ```/home/django/.ssh``` during build.
Don't forget include a corresponding docker-compose file.

### Build docker image
```bash
# From project root directory
docker-compose -f docker-compose.yml -f components/ssh/docker-compose.ssh.yml build
```

### Run docker container
```bash
# From project root directory
docker-compose -f docker-compose.yml -f components/ssh/docker-compose.ssh.yml up -d
```

0 comments on commit 575f181

Please sign in to comment.