Skip to content

Commit

Permalink
Docs: update Docker setup commands to remove container when done (#41079
Browse files Browse the repository at this point in the history
)
  • Loading branch information
mmahacek authored Oct 7, 2024
1 parent 775d26d commit 9b9d916
Show file tree
Hide file tree
Showing 5 changed files with 14 additions and 15 deletions.
3 changes: 1 addition & 2 deletions libbeat/docs/howto/load-index-templates.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,7 @@ ifdef::docker_platform[]

["source","sh",subs="attributes"]
----------------------------------------------------------------------
docker run {dockerimage} setup --index-management{disable_logstash} -E 'output.elasticsearch.hosts=["localhost:9200"]'
docker run --rm {dockerimage} setup --index-management{disable_logstash} -E 'output.elasticsearch.hosts=["localhost:9200"]'
----------------------------------------------------------------------
endif::docker_platform[]

Expand Down Expand Up @@ -354,4 +354,3 @@ endif::win_only[]
PS > Invoke-RestMethod -Method Put -Uri http://localhost:9200/_data_stream/{beatname_lc}-{version}
----
endif::win_os[]

14 changes: 7 additions & 7 deletions libbeat/docs/shared-docker.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ and machine learning jobs. Run this command:
ifeval::["{beatname_lc}"=="filebeat"]
["source", "sh", subs="attributes"]
--------------------------------------------
docker run \
docker run --rm \
{dockerimage} \
setup -E setup.kibana.host=kibana:5601 \
-E output.elasticsearch.hosts=["elasticsearch:9200"] <1> <2>
Expand All @@ -83,7 +83,7 @@ endif::[]
ifeval::["{beatname_lc}"=="metricbeat"]
["source", "sh", subs="attributes"]
--------------------------------------------
docker run \
docker run --rm \
{dockerimage} \
setup -E setup.kibana.host=kibana:5601 \
-E output.elasticsearch.hosts=["elasticsearch:9200"] <1> <2>
Expand All @@ -93,7 +93,7 @@ endif::[]
ifeval::["{beatname_lc}"=="heartbeat"]
["source", "sh", subs="attributes"]
--------------------------------------------
docker run \
docker run --rm \
--cap-add=NET_RAW \
{dockerimage} \
setup -E setup.kibana.host=kibana:5601 \
Expand All @@ -104,7 +104,7 @@ endif::[]
ifeval::["{beatname_lc}"=="packetbeat"]
["source", "sh", subs="attributes"]
--------------------------------------------
docker run \
docker run --rm \
--cap-add=NET_ADMIN \
{dockerimage} \
setup -E setup.kibana.host=kibana:5601 \
Expand All @@ -115,7 +115,7 @@ endif::[]
ifeval::["{beatname_lc}"=="auditbeat"]
["source", "sh", subs="attributes"]
--------------------------------------------
docker run \
docker run --rm \
--cap-add="AUDIT_CONTROL" \
--cap-add="AUDIT_READ" \
{dockerimage} \
Expand All @@ -139,7 +139,7 @@ endif::apm-server[]

==== Run {beatname_uc} on a read-only file system

If you'd like to run {beatname_uc} in a Docker container on a read-only file
If you'd like to run {beatname_uc} in a Docker container on a read-only file
system, you can do so by specifying the `--read-only` option.
{beatname_uc} requires a stateful directory to store application data, so
with the `--read-only` option you also need to use the `--mount` option to
Expand Down Expand Up @@ -185,7 +185,7 @@ docker run -d \
--volume="$(pwd)/{beatname_lc}.docker.yml:/usr/share/{beatname_lc}/{beatname_lc}.yml:ro" \
--volume="/var/lib/docker/containers:/var/lib/docker/containers:ro" \
--volume="/var/run/docker.sock:/var/run/docker.sock:ro" \
--volume="registry:/usr/share/{beatname_lc}/data:rw" \
--volume="registry:/usr/share/{beatname_lc}/data:rw" \
{dockerimage} {beatname_lc} -e --strict.perms=false \
-E output.elasticsearch.hosts=["elasticsearch:9200"] <1> <2>
--------------------------------------------
Expand Down
4 changes: 2 additions & 2 deletions libbeat/docs/tab-widgets/load-dashboards-logstash.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@
// tag::docker[]
["source","sh",subs="attributes"]
----
docker run --net="host" {dockerimage} setup -e \
docker run --rm --net="host" {dockerimage} setup -e \
-E output.logstash.enabled=false \
-E output.elasticsearch.hosts=['localhost:9200'] \
-E output.elasticsearch.username={beat_default_index_prefix}_internal \
Expand All @@ -73,4 +73,4 @@ PS > .{backslash}{beatname_lc}.exe setup -e `
-E output.elasticsearch.password={pwd} `
-E setup.kibana.host=localhost:5601
----
// end::win[]
// end::win[]
4 changes: 2 additions & 2 deletions libbeat/docs/tab-widgets/load-dashboards.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
// tag::docker[]
["source","sh",subs="attributes"]
----
docker run --net="host" {dockerimage} setup --dashboards
docker run --rm --net="host" {dockerimage} setup --dashboards
----
// end::docker[]

Expand All @@ -45,4 +45,4 @@ and run:
----
PS > .{backslash}{beatname_lc}.exe setup --dashboards
----
// end::win[]
// end::win[]
4 changes: 2 additions & 2 deletions libbeat/docs/tab-widgets/load-index-template.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
// tag::docker[]
["source","sh",subs="attributes"]
----
docker run --net="host" {dockerimage} setup --index-management
docker run --rm --net="host" {dockerimage} setup --index-management
----
// end::docker[]

Expand All @@ -45,4 +45,4 @@ and run:
----
PS > .{backslash}{beatname_lc}.exe setup --index-management
----
// end::win[]
// end::win[]

0 comments on commit 9b9d916

Please sign in to comment.