-
Notifications
You must be signed in to change notification settings - Fork 8.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
57 changed files
with
327 additions
and
250 deletions.
There are no files selected for viewing
Validating CODEOWNERS rules …
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
{ | ||
"name": "@kbn/es-archiver", | ||
"version": "1.0.0", | ||
"license": "Apache-2.0", | ||
"main": "target/index.js", | ||
"scripts": { | ||
"kbn:bootstrap": "tsc", | ||
"kbn:watch": "tsc --watch" | ||
}, | ||
"dependencies": { | ||
"@kbn/dev-utils": "1.0.0", | ||
"elasticsearch": "^16.7.0" | ||
}, | ||
"devDependencies": { | ||
"@types/elasticsearch": "^5.0.33" | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,244 @@ | ||
/* | ||
* Licensed to Elasticsearch B.V. under one or more contributor | ||
* license agreements. See the NOTICE file distributed with | ||
* this work for additional information regarding copyright | ||
* ownership. Elasticsearch B.V. licenses this file to you under | ||
* the Apache License, Version 2.0 (the "License"); you may | ||
* not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, | ||
* software distributed under the License is distributed on an | ||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | ||
* KIND, either express or implied. See the License for the | ||
* specific language governing permissions and limitations | ||
* under the License. | ||
*/ | ||
|
||
/** *********************************************************** | ||
* | ||
* Run `node scripts/es_archiver --help` for usage information | ||
* | ||
*************************************************************/ | ||
|
||
import Path from 'path'; | ||
import Url from 'url'; | ||
import readline from 'readline'; | ||
|
||
import { RunWithCommands, createFlagError } from '@kbn/dev-utils'; | ||
import { readConfigFile } from '@kbn/test'; | ||
import legacyElasticsearch from 'elasticsearch'; | ||
|
||
import { EsArchiver } from './es_archiver'; | ||
|
||
const resolveConfigPath = (v: string) => Path.resolve(process.cwd(), v); | ||
const defaultConfigPath = resolveConfigPath('test/functional/config.js'); | ||
|
||
export function runCli() { | ||
new RunWithCommands({ | ||
description: 'CLI to manage archiving/restoring data in elasticsearch', | ||
globalFlags: { | ||
string: ['es-url', 'kibana-url', 'dir', 'config'], | ||
help: ` | ||
--config path to an FTR config file that sets --es-url, --kibana-url, and --dir | ||
default: ${defaultConfigPath} | ||
--es-url url for Elasticsearch, prefer the --config flag | ||
--kibana-url url for Kibana, prefer the --config flag | ||
--dir where arechives are stored, prefer the --config flag | ||
`, | ||
}, | ||
async extendContext({ log, flags, addCleanupTask }) { | ||
const configPath = flags.config || defaultConfigPath; | ||
if (typeof configPath !== 'string') { | ||
throw createFlagError('--config must be a string'); | ||
} | ||
const config = await readConfigFile(log, Path.resolve(configPath)); | ||
|
||
let esUrl = flags['es-url']; | ||
if (esUrl && typeof esUrl !== 'string') { | ||
throw createFlagError('--es-url must be a string'); | ||
} | ||
if (!esUrl && config) { | ||
esUrl = Url.format(config.get('servers.elasticsearch')); | ||
} | ||
if (!esUrl) { | ||
throw createFlagError('--es-url or --config must be defined'); | ||
} | ||
|
||
let kibanaUrl = flags['kibana-url']; | ||
if (kibanaUrl && typeof kibanaUrl !== 'string') { | ||
throw createFlagError('--kibana-url must be a string'); | ||
} | ||
if (!kibanaUrl && config) { | ||
kibanaUrl = Url.format(config.get('servers.kibana')); | ||
} | ||
if (!kibanaUrl) { | ||
throw createFlagError('--kibana-url or --config must be defined'); | ||
} | ||
|
||
let dir = flags.dir; | ||
if (dir && typeof dir !== 'string') { | ||
throw createFlagError('--dir must be a string'); | ||
} | ||
if (!dir && config) { | ||
dir = Path.resolve(config.get('esArchiver.directory')); | ||
} | ||
if (!dir) { | ||
throw createFlagError('--dir or --config must be defined'); | ||
} | ||
|
||
const client = new legacyElasticsearch.Client({ | ||
host: esUrl, | ||
log: flags.verbose ? 'trace' : [], | ||
}); | ||
addCleanupTask(() => client.close()); | ||
|
||
const esArchiver = new EsArchiver({ | ||
log, | ||
client, | ||
dataDir: dir, | ||
kibanaUrl, | ||
}); | ||
|
||
return { | ||
esArchiver, | ||
}; | ||
}, | ||
}) | ||
.command({ | ||
name: 'save', | ||
usage: 'save [name] [...indices]', | ||
description: ` | ||
archive the [indices ...] into the --dir with [name] | ||
Example: | ||
Save all [logstash-*] indices from http://localhost:9200 to [snapshots/my_test_data] directory | ||
WARNING: If the [my_test_data] snapshot exists it will be deleted! | ||
$ node scripts/es_archiver save my_test_data logstash-* --dir snapshots | ||
`, | ||
flags: { | ||
boolean: ['raw'], | ||
help: ` | ||
--raw don't gzip the archives | ||
`, | ||
}, | ||
async run({ flags, esArchiver }) { | ||
const [name, ...indices] = flags._; | ||
if (!name) { | ||
throw createFlagError('missing [name] argument'); | ||
} | ||
if (!indices.length) { | ||
throw createFlagError('missing [...indices] arguments'); | ||
} | ||
|
||
const raw = flags.raw; | ||
if (typeof raw !== 'boolean') { | ||
throw createFlagError('--raw does not take a value'); | ||
} | ||
|
||
await esArchiver.save(name, indices, { raw }); | ||
}, | ||
}) | ||
.command({ | ||
name: 'load', | ||
usage: 'load [name]', | ||
description: ` | ||
load the archive in --dir with [name] | ||
Example: | ||
Load the [my_test_data] snapshot from the archive directory and elasticsearch instance defined | ||
in the [test/functional/config.js] config file | ||
WARNING: If the indices exist already they will be deleted! | ||
$ node scripts/es_archiver load my_test_data --config test/functional/config.js | ||
`, | ||
flags: { | ||
boolean: ['use-create'], | ||
help: ` | ||
--use-create use create instead of index for loading documents | ||
`, | ||
}, | ||
async run({ flags, esArchiver }) { | ||
const [name] = flags._; | ||
if (!name) { | ||
throw createFlagError('missing [name] argument'); | ||
} | ||
if (flags._.length > 1) { | ||
throw createFlagError(`unknown extra arguments: [${flags._.slice(1).join(', ')}]`); | ||
} | ||
|
||
const useCreate = flags['use-create']; | ||
if (typeof useCreate !== 'boolean') { | ||
throw createFlagError('--use-create does not take a value'); | ||
} | ||
|
||
await esArchiver.load(name, { useCreate }); | ||
}, | ||
}) | ||
.command({ | ||
name: 'unload', | ||
usage: 'unload [name]', | ||
description: 'remove indices created by the archive in --dir with [name]', | ||
async run({ flags, esArchiver }) { | ||
const [name] = flags._; | ||
if (!name) { | ||
throw createFlagError('missing [name] argument'); | ||
} | ||
if (flags._.length > 1) { | ||
throw createFlagError(`unknown extra arguments: [${flags._.slice(1).join(', ')}]`); | ||
} | ||
|
||
await esArchiver.unload(name); | ||
}, | ||
}) | ||
.command({ | ||
name: 'edit', | ||
usage: 'edit [prefix]', | ||
description: | ||
'extract the archives under the prefix, wait for edits to be completed, and then recompress the archives', | ||
async run({ flags, esArchiver }) { | ||
const [prefix] = flags._; | ||
if (!prefix) { | ||
throw createFlagError('missing [prefix] argument'); | ||
} | ||
if (flags._.length > 1) { | ||
throw createFlagError(`unknown extra arguments: [${flags._.slice(1).join(', ')}]`); | ||
} | ||
|
||
await esArchiver.edit(prefix, async () => { | ||
const rl = readline.createInterface({ | ||
input: process.stdin, | ||
output: process.stdout, | ||
}); | ||
|
||
await new Promise((resolveInput) => { | ||
rl.question(`Press enter when you're done`, () => { | ||
rl.close(); | ||
resolveInput(); | ||
}); | ||
}); | ||
}); | ||
}, | ||
}) | ||
.command({ | ||
name: 'empty-kibana-index', | ||
description: | ||
'[internal] Delete any Kibana indices, and initialize the Kibana index as Kibana would do on startup.', | ||
async run({ esArchiver }) { | ||
await esArchiver.emptyKibanaIndex(); | ||
}, | ||
}) | ||
.command({ | ||
name: 'rebuild-all', | ||
description: '[internal] read and write all archives in --dir to remove any inconsistencies', | ||
async run({ esArchiver }) { | ||
await esArchiver.rebuildAll(); | ||
}, | ||
}) | ||
.execute(); | ||
} |
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -18,3 +18,4 @@ | |
*/ | ||
|
||
export { EsArchiver } from './es_archiver'; | ||
export * from './cli'; |
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
Oops, something went wrong.