Towards a1 1.0.0: rmr improvements
[ric-plt/a1.git] / docs / index.rst
1 .. ==================================================================================
2 ..       Copyright (c) 2019 Nokia
3 ..       Copyright (c) 2018-2019 AT&T Intellectual Property.
4 ..
5 ..   Licensed under the Apache License, Version 2.0 (the "License");
6 ..   you may not use this file except in compliance with the License.
7 ..   You may obtain a copy of the License at
8 ..
9 ..          http://www.apache.org/licenses/LICENSE-2.0
10 ..
11 ..   Unless required by applicable law or agreed to in writing, software
12 ..   distributed under the License is distributed on an "AS IS" BASIS,
13 ..   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 ..   See the License for the specific language governing permissions and
15 ..   limitations under the License.
16 .. ==================================================================================
17
18 A1 Mediator
19 ===========
20
21 API
22 ===
23
24 You can see the API (OpenAPI3 spec) at ``a1/openapi.yml``. You can also
25 see the “pretty” version if you run the container at
26 ``http://localhost:10000/ui/``.
27
28 Running
29 =======
30
31 Optional ENV Variables
32 ----------------------
33
34 You can set the following ENVs to change the A1 behavior:
35
36 1. ``RMR_RETRY_TIMES`` the number of times failed rmr operations such as
37 timeouts and send failures should be retried before A1 gives up and
38 returns a 503. The default is ``4``.
39
40 K8S
41 ---
42 The "real" helm chart for A1 is in the LF it/dep repo. That repo holds all of the helm charts for the RIC platform. There is a helm chart in `integration_tests` here for running the integration tests as discussed above.
43
44 Local Docker
45 ------------
46
47 building
48 ~~~~~~~~
49 ::
50
51    docker build --no-cache -t a1:X.Y.Z .
52
53 .. _running-1:
54
55 running
56 ~~~~~~~
57
58 ::
59
60    docker run -dt -p 10000:10000 -v /path/to/localrt:/opt/route/local.rt -v /path/to/ricmanifest:/opt/ricmanifest.json a1:X.Y.Z -v