X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?p=src%2Fxds%2Fxds-agent.git;a=blobdiff_plain;f=README.md;h=caf7d20bfc92bb89bdcc2d21f30aaed27ba1c6ac;hp=06d0725f1d27d216e88a47cf5838ab245a546ed1;hb=c2558601c7ce2b7fd7eaf7c2336fb78242781e50;hpb=03ea9e0e7107d59f207b3842f9fc3f74d036ac91 diff --git a/README.md b/README.md index 06d0725..caf7d20 100644 --- a/README.md +++ b/README.md @@ -1,92 +1,14 @@ # XDS - X(cross) Development System Agent -XDS-agent is an agent that should 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. +[http://docs.automotivelinux.org/docs/devguides/en/dev/#xcross-development-system-user's-guide](http://docs.automotivelinux.org/docs/devguides/en/dev/#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.8 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 (by default in `/usr/local/bin`): -```bash -make install -``` - ->**NOTE:** Used `DESTDIR` to specify another install directory ->```bash ->make install DESTDIR=$HOME/opt/xds-agent ->``` - - -#### Cross build -For example on a Linux machine to cross-build for Windows, just execute: -```bash -export GOOS=windows -export GOARCH=amd64 -make all -make package -``` - -## 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", - "logsDir": "directory to store logs (eg. syncthing output)", - "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)", - "gui-apikey": "syncthing api-key to use (default auto-generated)" - } -} -``` - ->**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`. +[http://docs.automotivelinux.org/docs/devguides/en/dev/reference/xds/part-2/2_xds-agent.html](http://docs.automotivelinux.org/docs/devguides/en/dev/reference/xds/part-2/2_xds-agent.html)