X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?p=src%2Fxds%2Fxds-agent.git;a=blobdiff_plain;f=README.md;h=2a23230e939c7823223f2d1c003f3a5f5470d5b3;hp=d72ed9575cf7385724fbc00831f72712ccb511f7;hb=6cd671fd3ece1d14690ddc7b2a3835966497fe79;hpb=bfeab33538d50ee52750de4dd4c0e72b64f674f6 diff --git a/README.md b/README.md index d72ed95..2a23230 100644 --- a/README.md +++ b/README.md @@ -1,74 +1,14 @@ # XDS - X(cross) Development System Agent -XDS-agent is a agent that should be run on your local machine when you use XDS. +XDS-agent is a client that should run on your local / user development machine +when you use XDS. -This agent takes care of starting [Syncthing](https://syncthing.net/) tool to synchronize your projects files from your local machine to build server machine -or container. +## Documentation +Please find XDS User's Guide online at : -> **SEE ALSO**: [xds-server](https://github.com/iotbzh/xds-server), a web server -used to remotely cross build applications. +[https://docs.automotivelinux.org/docs/en/master/devguides/#xcross-development-system-user's-guide](https://docs.automotivelinux.org/docs/en/master/devguides/#xcross-development-system-user's-guide) +and `xds-agent` advanced documentation at : -## How to build - -### Dependencies - -- Install and setup [Go](https://golang.org/doc/install) version 1.7 or -higher to compile this tool. - - -### Building - -Clone this repo into your `$GOPATH/src/github.com/iotbzh` and use delivered Makefile: -```bash - mkdir -p $GOPATH/src/github.com/iotbzh - cd $GOPATH/src/github.com/iotbzh - git clone https://github.com/iotbzh/xds-agent.git - cd xds-agent - make all -``` - -And to install xds-agent in /usr/local/bin: -```bash -make install -``` - -## How to run - -## Configuration - -xds-agent configuration is driven by a JSON config file (`agent-config.json`). - -Here is the logic to determine which `agent-config.json` file will be used: -1. from command line option: `--config myConfig.json` -2. `$HOME/.xds/agent-config.json` file -3. `/agent-config.json` file -4. `/agent-config.json` file - -Supported fields in configuration file are: -```json -{ - "httpPort": "http port of agent REST interface", - "syncthing": { - "binDir": "syncthing binaries directory (use xds-agent executable dir when not set)", - "home": "syncthing home directory (usually .../syncthing-config)", - "gui-address": "syncthing gui url (default http://localhost:8384)" - } -} -``` - ->**NOTE:** environment variables are supported by using `${MY_VAR}` syntax. - -## Start-up - -```bash -./bin/xds-agent.sh - -# OR if you have install agent - -/usr/local/bin/xds-agent.sh -``` - ->**NOTE** you can define some environment variables to setup for example -config file `XDS_CONFIGFILE` or change logs level `LOG_LEVEL`. +[https://docs.automotivelinux.org/docs/en/master/devguides/reference/xds/part-2/2_xds-agent/0_abstract.html](https://docs.automotivelinux.org/docs/en/master/devguides/reference/xds/part-2/2_xds-agent/0_abstract.html)