cradle-elastic
Backup and restore Elasticsearch indices
TLDR
Truncate the Elasticsearch index
Truncate the Elasticsearch index for a specific package
Submit the Elasticsearch schema
Submit the Elasticsearch schema for a specific package
Populate the Elasticsearch indices for all packages
Populate the Elasticsearch indices for a specific package
SYNOPSIS
cradle-elastic <command> [options]
Examples of probable usage:
cradle-elastic start --version 7.10.2 --port 9200
cradle-elastic stop
cradle-elastic clean
cradle-elastic info
PARAMETERS
start
Initializes and starts a new or existing Elasticsearch instance. Often supports specifying the version and port.
stop
Gracefully stops the running Elasticsearch instance managed by the tool.
clean or destroy
Shuts down the instance and removes its data directory and associated files, effectively resetting the environment.
info
Displays information about the currently managed Elasticsearch instance, such as its version, port, and status.
--version <version>
Specifies the exact version of Elasticsearch to download and run (e.g., 7.10.2, 8.5.0). Applicable to the 'start' command.
--port <number>
Defines the network port on which Elasticsearch should listen (e.g., 9200). Applicable to the 'start' command.
--data-dir <path>
Sets a custom directory where Elasticsearch data should be stored. Applicable to the 'start' command.
--timeout <duration>
Specifies how long to wait for Elasticsearch to start up successfully.
DESCRIPTION
The command cradle-elastic is not a standard Linux command found in common distributions' core utilities or `man` pages. It is highly likely a custom script or a specialized utility, often part of a specific project's development or testing toolkit, designed to manage local instances of Elasticsearch. Its primary purpose is to simplify the setup, lifecycle, and teardown of Elasticsearch environments, typically for integration testing, local application development, or Continuous Integration (CI) pipelines. This kind of tool often abstracts away the complexities of downloading, configuring, starting, and stopping Elasticsearch, making it easier for developers to work with an Elasticsearch dependency without manual setup. It might be built upon existing tools like go-cradle or similar Go-based utilities that provide an API for controlling Elasticsearch instances programmatically. Its functionality would be entirely dependent on the specific project it belongs to.
CAVEATS
cradle-elastic is NOT a standard Linux utility. Its availability, exact syntax, and functionality are entirely dependent on the specific software project or development environment it was created for. It is not part of any common Linux distribution's default package set. Users should not expect to find this command pre-installed or universally documented via man pages on general-purpose Linux systems. It is primarily a development/testing tool and should not be used for production deployments of Elasticsearch.
Documentation for this command would typically be found within the specific project's README, developer documentation, or source code.
HISTORY
The concept behind tools like cradle-elastic emerged with the increasing complexity of microservices and applications that depend on external services like Elasticsearch during development and testing. Manually setting up and tearing down these services for every test run or local development session became cumbersome. Tools like go-cradle (a known project for managing Elasticsearch instances for Go tests) inspired similar custom scripts and utilities across different programming languages and projects. While a specific history for cradle-elastic as a standalone, widely adopted command doesn't exist, its lineage traces back to the need for automated, ephemeral, and isolated service environments in modern software development workflows, particularly in CI/CD pipelines and local integration testing.