docker-library
/
docs
mirror of https://github.com/docker-library/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Run update.sh

This commit is contained in:
Docker Library Bot 2016-02-26 17:30:11 -08:00
parent 59696690b7
commit d403024d7d
1 changed files with 43 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
arangodb/README.md
View File

@ -33,27 +33,27 @@ Joins and Transactions are key features for flexible, secure data designs, widel
Furthermore, ArangoDB offers a microservice framework called [Foxx](https://www.arangodb.com/foxx) to build your own Rest API with a few lines of code. Furthermore, ArangoDB offers a microservice framework called [Foxx](https://www.arangodb.com/foxx) to build your own Rest API with a few lines of code.
ArangoDB Documentation #### ArangoDB Documentation
- [ArangoDB Documentation](https://www.arangodb.com/documentation) - [ArangoDB Documentation](https://www.arangodb.com/documentation)
- [ArangoDB Tutorials](https://www.arangodb.com/tutorials) - [ArangoDB Tutorials](https://www.arangodb.com/tutorials)
## How to use this image ## How to use this image
### Start an `ArangoDB` instance ### Start an ArangoDB instance
In order to start an ArangoDB instance run In order to start an ArangoDB instance run
```console ```console
$ docker run -d --name arangodb-instance arangodb unix> docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 -d --name arangodb-instance -d arangodb
``` ```
Will create and launch the arangodb docker instance as background process. The Identifier of the process is printed - the plain text name will be *arangodb-instance* as you stated above. By default ArangoDB listen on port 8529 for request and the image includes `EXPOST 8529`. If you link an application container it is automatically available in the linked container. See the following examples. Will create and launch the arangodb docker instance as background process. The Identifier of the process is printed. By default ArangoDB listen on port 8529 for request and the image includes `EXPOSE 8529`. If you link an application container it is automatically available in the linked container. See the following examples.
In order to get the IP arango listens on run: In order to get the IP arango listens on run:
```console ```console
$ docker inspect --format '{{ .NetworkSettings.IPAddress }}' arangodb-instance unix> docker inspect --format '{{ .NetworkSettings.IPAddress }}' arangodb-instance
``` ```
### Using the instance ### Using the instance
@ -61,7 +61,7 @@ $ docker inspect --format '{{ .NetworkSettings.IPAddress }}' arangodb-instance
In order to use the running instance from an application, link the container In order to use the running instance from an application, link the container
```console ```console
$ docker run --name my-arangodb-app --link arangodb-instance:db-link arangodb unix> docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 --name my-app --link arangodb-instance:db-link arangodb
``` ```
This will use the instance with the name `arangodb-instance` and link it into the application container. The application container will contain environment variables This will use the instance with the name `arangodb-instance` and link it into the application container. The application container will contain environment variables
@ -79,15 +79,44 @@ These can be used to access the database.
If you want to expose the port to the outside world, run If you want to expose the port to the outside world, run
```console ```console
$ docker run -p 8529:8529 -d arangodb unix> docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 -p 8529:8529 -d arangodb
``` ```
ArangoDB listen on port 8529 for request and the image includes `EXPOST 8529`. The `-p 8529:8529` exposes this port on the host. ArangoDB listen on port 8529 for request and the image includes `EXPOSE
8529`. The `-p 8529:8529` exposes this port on the host.
### Choosing an authentication method
The ArangoDB image provides several authentication methods which can be specified via environment variables (-e) when using `docker run`
1. ARANGO_RANDOM_ROOT_PASSWORD=1
Generate a random root password when starting. The password will be printed to stdout (may be inspected later using `docker logs`)
2. ARANGO_NO_AUTH=1
Disable authentication. Useful for testing.
**WARNING** Doing so in production will expose all your data. Make sure that ArangoDB is not diretcly accessible from the internet!
3. ARANGO_ROOT_PASSWORD=somepassword
Specify your own root password.
### Command line options
In order to get a list of supported options, run
```console
unix> docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 arangodb arangod --help
```
## Persistent Data ## Persistent Data
ArangoDB use the volume `/var/lib/arangodb` as database directory to store the collection data and the volume `/var/lib/arangodb-apps` as apps directory to store any extensions. These directories are marked as docker volumes. ArangoDB use the volume `/var/lib/arangodb` as database directory to store the collection data and the volume `/var/lib/arangodb-apps` as apps directory to store any extensions. These directories are marked as docker volumes.
See `docker inspect --format "{{ .Config.Volumes}}" arangodb` for all volumes.
A good explanation about persistence and docker container can be found here: [Docker In-depth: Volumes](http://container42.com/2014/11/03/docker-indepth-volumes/), [Why Docker Data Containers are Good](https://medium.com/@ramangupta/why-docker-data-containers-are-good-589b3c6c749e) A good explanation about persistence and docker container can be found here: [Docker In-depth: Volumes](http://container42.com/2014/11/03/docker-indepth-volumes/), [Why Docker Data Containers are Good](https://medium.com/@ramangupta/why-docker-data-containers-are-good-589b3c6c749e)
### Using host directories ### Using host directories
@ -95,50 +124,32 @@ A good explanation about persistence and docker container can be found here: [Do
You can map the container's volumes to a directory on the host, so that the data is kept between runs of the container. This path `/tmp/arangodb` is in general not the correct place to store you persistent files - it is just an example! You can map the container's volumes to a directory on the host, so that the data is kept between runs of the container. This path `/tmp/arangodb` is in general not the correct place to store you persistent files - it is just an example!
```console ```console
$ mkdir /tmp/arangodb unix> mkdir /tmp/arangodb
$ docker run -p 8529:8529 -d \ unix> docker -e ARANGO_RANDOM_ROOT_PASSWORD=1 run -p 8529:8529 -d \
-v /tmp/arangodb:/var/lib/arangodb \ -v /tmp/arangodb:/var/lib/arangodb \
arangodb arangodb
``` ```
This will use the `/tmp/arangodb` directory of the host as database directory for ArangoDB inside the container. This will use the `/tmp/arangodb` directory of the host as database directory for ArangoDB inside the container.
## Using a custom ArangoDB configuration file
The ArangoDB startup configuration is specified in the file `/etc/arangodb/arangodb.conf`. If you want to use a customized ArangoDB configuration, you can create your alternative configuration file in a directory on the host machine and then mount that directory location as `/etc/arangodb` inside the `arangodb` container.
If `/my/custom/arangod.conf` is the path of your arangodb configuration file, you can start your `arangodb` container like this:
```console
$ docker run --name some-arangodb -v /my/custom:/etc/arangodb -d arangodb:tag
```
This will start a new container `some-arangodb` where the ArangoDB instance uses the startup settings from your config file instead of the default one.
Note that users on host systems with SELinux enabled may see issues with this. The current workaround is to assign the relevant SELinux policy type to your new config file so that the container will be allowed to mount it:
```console
$ chcon -Rt svirt_sandbox_file_t /my/custom
```
### Using a data container ### Using a data container
Alternatively you can create a container holding the data. Alternatively you can create a container holding the data.
```console ```console
$ docker run -d --name arangodb-persist -v /var/lib/arangodb debian:8.0 true unix> docker create --name arangodb-persist arangodb true
``` ```
And use this data container in your ArangoDB container. And use this data container in your ArangoDB container.
```console ```console
$ docker run --volumes-from arangodb-persist -p 8529:8529 arangodb unix> docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 --volumes-from arangodb-persist -p 8529:8529 arangodb
``` ```
If want to save a few bytes you can alternatively use [hello-world](https://registry.hub.docker.com/_/hello-world/), [busybox](https://registry.hub.docker.com/_/busybox/) or [alpine](https://registry.hub.docker.com/_/alpine/) for creating the volume only containers. For example: If want to save a few bytes you can alternatively use [busybox](https://registry.hub.docker.com/_/busybox) or [alpine](https://registry.hub.docker.com/_/alpine) for creating the volume only containers. Please note that you need to provide the used volumes in this case. For example
```console ```console
$ docker run -d --name arangodb-persist -v /var/lib/arangodb alpine alpine unix> docker run -d --name arangodb-persist -v /var/lib/arangodb busybox true
``` ```
# License # License