# 整体结构

源代码主要分为5个目录和若干文件： bin，doc，etc，neutron和tools。 除了这 5 个目录外，还包括一些说明文档、安装需求说明文件等。

## bin

主要包括 neutron-rootwrap、neutron-rootwrap-xen-dom0 两个文件。 提供一些可执行命令。

## doc

包括文档生成的相关源码。

## etc

跟服务和配置相关的文件，基本上该目录中内容在安装时会被复制到系统的/etc/ 目录下。

* init.d/neutron-server：neutron-server 系统服务脚本，支持 start、stop、restart 和 status 操作。
* neutron/: 核心的库代码。
* plugins/: 各种厂商的 plugin 相关的配置文件（\*.ini），其中被注释掉的行表明了默认值。
* rootwrap.d/: 一些 filters 文件，用来限定各个模块执行命令的权限。

  各种 ini 和 conf 文件，包括 api-paste.ini、dhcp\_agent.ini、l3\_agent.ini、fwaas\_driver.ini、lbaas\_agent.ini、metadata\_agent.ini、metering\_agent.ini，以及 neutron.conf、policy.json、rootwrap.conf、services.conf 等。

  基本上 neutron 相关的各个组件的配置信息都在这里了。

## neutron

核心的代码实现都在这个目录下。 可以通过下面的命令来统计主要实现的核心代码量。

```
find neutron  -name "*.py" | xargs cat | wc -l
```

目前版本，约为226k行。

## tools

一些相关的代码格式化检测、环境安装的脚本。

## 其它文档

* README.rst：介绍了项目的情况和连接。
* TESTING.rst：介绍如何进行开发后的测试。官方配置的 jenkins 当 gerrit 上有代码提交 review 的时候会触发 tox 测试。实际上，OpenStack 中的项目使用 [tox](http://tox.readthedocs.org/en/latest/) 来管理测试的虚拟环境，使用 [testr](https://wiki.openstack.org/wiki/Testr) 来管理运行测试案例的顺序。
* run\_tests.sh：自动创建一个虚拟环境并进行测试。命令为 `./run_tests -V`。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yeasy.gitbook.io/openstack_code_neutron/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.