Simplified doc-site generation
[AGL/documentation.git] / docs / ATTIC / 3_Developer_Guides / 4_X(cross)_Development_System:_User's_Guide / 4_X(cross)_Development_System:_ Internals / 3.4.4.2_xds-server / 3.4.4.2.4_Debug.md
1 <!-- WARNING: This file is generated by fetch_docs.js using /home/boron/Documents/AGL/docs-webtemplate/site/_data/tocs/devguides/master/xds-docs-guides-devguides-book.yml -->
2 # Debugging
3
4 ## XDS server architecture
5
6 The server part is written in *Go* and web app (basic HTML) in *Angular4*.
7
8 ```bash
9 |
10 +-- bin/                # where xds-server binary file will be built
11 |
12 +-- conf.d/             # Linux configuration and startup files (systemd user service)
13 |
14 +-- glide.yaml          # Go package dependency file
15 |
16 +-- lib/                # sources of server part (Go)
17 |
18 +-- LICENSE             # XDS server license
19 |
20 +-- main.go             # main entry point of of Web server (Go)
21 |
22 +-- Makefile            # makefile including
23 |
24 +-- README.md           # readme
25 |
26 +-- scripts/            # hold various scripts used for installation or startup
27 |
28 +-- test/               # XDS test suite
29 |
30 +-- tools/              # temporary directory to hold development tools (like glide)
31 |
32 +-- vendor/             # temporary directory to hold Go dependencies packages
33 |
34 +-- webapp/             # source client basic web application
35 ```
36
37 ## Debug server part (Go code)
38
39 Install first [Visual Studio Code](https://code.visualstudio.com/) and
40 [Go plugin](https://marketplace.visualstudio.com/items?itemName=lukehoban.Go)
41 (`ext install lukehoban.Go`)
42
43 Visual Studio Code launcher settings can be found into `.vscode/launch.json`.
44
45 Please follow instructions of xds-agent [debugging chapter](../2_xds-agent/4_debug.html#debug-xds-agent-go-code),
46 knowing that you execute these same instructions in `xds-server` repo, in other words
47 by replacing *xds-agent* references by *xds-server*.