logstash-filter-geoip 7.2.2-java → 7.2.3-java

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 228cb2db9a6c6d725886c8a93970bf7c6f63ab5eaf838bce2777b2c88eea02f6
4
- data.tar.gz: e52ec1454cc7658c4a61db2527058607a825b9ae0cde5fb270791e40b32ed067
3
+ metadata.gz: 41186204a9754322404e62bfb7d3f6bc6c2cac0eae3d94216ca0d1d1aea2224e
4
+ data.tar.gz: 53c94c8805f0d75ec63da781d6aa5f5183cfd59d71b13ef91ef311bca60317e9
5
5
  SHA512:
6
- metadata.gz: 2b4addd23f4ad628dcf9a4d28638ea80f75a0774f0e2e1cb85be9777d1a08072ebbe3ff1a3e0d42bab957a0f397679dfeed507cff57e48e6a1b47cb3080a5780
7
- data.tar.gz: 18fad8acf816a24f205a2b6c5f17518e07e96c7a9e62e7e1c38f05023a719306ce20f3bd67c954454b87e7daa225e4a26ead88290e7b6b14cf37283762beef79
6
+ metadata.gz: 80c10a490592b1ed119439e71c9b783c8853e52849023427c3441551737460e50f0c14be40d445030804e5258a1752b5ceef0cd40f7f4107ee206c05d3f6f50a
7
+ data.tar.gz: e8d231040a51664a4729a5eb06947d42249b34ed8e25ae74b7ef94c5ccb9b4a14966deeb99bb731e68ea66d1eef20b7d7b71103fb5902d491d249b4e5dd5eb7d
data/CHANGELOG.md CHANGED
@@ -1,3 +1,6 @@
1
+ ## 7.2.3
2
+ - [DOC] Add documentation for bootstrapping air-gapped environment for database auto-update [#189](https://github.com/logstash-plugins/logstash-filter-geoip/pull/189)
3
+
1
4
  ## 7.2.2
2
5
  - [DOC] Add documentation for database auto-update behavior and database metrics [#187](https://github.com/logstash-plugins/logstash-filter-geoip/pull/187)
3
6
 
data/docs/index.asciidoc CHANGED
@@ -70,6 +70,49 @@ Events will be tagged with `_geoip_expired_database` tag to facilitate the handl
70
70
 
71
71
  TIP: When possible, allow Logstash to access the internet to download databases so that they are always up-to-date.
72
72
 
73
+ [id="plugins-{type}s-{plugin}-manage_update"]
74
+ ==== Manage your own database updates
75
+
76
+ **Use a proxy endpoint**
77
+
78
+ If you can't connect directly to the Elastic GeoIP endpoint, consider setting up
79
+ a secure proxy. You can then specify the proxy endpoint URL in the
80
+ `xpack.geoip.download.endpoint` setting in `logstash.yml` file.
81
+
82
+ **Use a custom endpoint**
83
+
84
+ If you work in air-gapped environment and can't update your databases from the Elastic endpoint,
85
+ you can bootstrap the environment as follows.
86
+
87
+ You can create a service that mimics the Elastic GeoIP endpoint. You can then
88
+ get automatic updates from this service.
89
+
90
+ . Download your `.mmdb` database files from the
91
+ http://dev.maxmind.com/geoip/geoip2/geolite2[MaxMind site].
92
+
93
+ . Copy your database files to a single directory.
94
+
95
+ . https://www.elastic.co/downloads/elasticsearch[Download {es}].
96
+
97
+ . From your {es} directory, run:
98
+ +
99
+ [source,sh]
100
+ ----
101
+ ./bin/elasticsearch-geoip -s my/database/dir
102
+ ----
103
+
104
+ . Serve the static database files from your directory. For example, you can use
105
+ Docker to serve the files from nginx server:
106
+ +
107
+ [source,sh]
108
+ ----
109
+ docker run -p 8080:80 -v my/database/dir:/usr/share/nginx/html:ro nginx
110
+ ----
111
+
112
+ . Specify the service's endpoint URL using the
113
+ `xpack.geoip.download.endpoint=http://localhost:8080/overview.json` setting in `logstash.yml`.
114
+
115
+
73
116
  [id="plugins-{type}s-{plugin}-metrics"]
74
117
  ==== Database Metrics
75
118
 
@@ -1,7 +1,7 @@
1
1
  Gem::Specification.new do |s|
2
2
 
3
3
  s.name = 'logstash-filter-geoip'
4
- s.version = '7.2.2'
4
+ s.version = '7.2.3'
5
5
  s.licenses = ['Apache License (2.0)']
6
6
  s.summary = "Adds geographical information about an IP address"
7
7
  s.description = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: logstash-filter-geoip
3
3
  version: !ruby/object:Gem::Version
4
- version: 7.2.2
4
+ version: 7.2.3
5
5
  platform: java
6
6
  authors:
7
7
  - Elastic
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-06-23 00:00:00.000000000 Z
11
+ date: 2021-09-29 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  requirement: !ruby/object:Gem::Requirement
@@ -152,8 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
152
152
  - !ruby/object:Gem::Version
153
153
  version: '0'
154
154
  requirements: []
155
- rubyforge_project:
156
- rubygems_version: 2.6.13
155
+ rubygems_version: 3.1.6
157
156
  signing_key:
158
157
  specification_version: 4
159
158
  summary: Adds geographical information about an IP address