Influxdata
/
influxdb
mirror of https://github.com/influxdata/influxdb.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

fix: remove influx CLI output from CONTRIBUTING (#22946) 

* fix: remove influx CLI output from CONTRIBUTING. Add link to influx CLI repo. Cleanup build instructions. Update Flux in README.

* fix: headers
pull/22949/head
Jason Stirnaman 2021-11-30 14:02:20 -06:00 committed by GitHub
parent 799d349813
commit 5ce164f849
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 43 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
CONTRIBUTING.md
View File

@ -124,34 +124,41 @@ You also need `clang`, `make`, `pkg-config`, and `protobuf` installed.
- Linux (Ubuntu): `sudo apt install make clang pkg-config protobuf-compiler libprotobuf-dev` - Linux (Ubuntu): `sudo apt install make clang pkg-config protobuf-compiler libprotobuf-dev`
- Linux (RHEL): See below - Linux (RHEL): See below
#### Redhat-specific instructions #### RedHat-specific instructions
For RedHat, you must enable the [EPEL](https://fedoraproject.org/wiki/EPEL) For RedHat, you must enable the [EPEL](https://fedoraproject.org/wiki/EPEL)
### Building with make ### Building with make
A successful `make` run results in two binaries, with platform-dependent paths: `influxd` is the InfluxDB service.
For `influx`, the InfluxDB CLI tool, see the [influx-cli repository on Github](https://github.com/influxdata/influx-cli).
Once you've installed the dependencies,
follow these steps to build `influxd` from source and start the service:
1. Clone this repo (influxdb).
2. In your influxdb directory, run `make`.
`make` generates the influxd binary at a platform-dependent path:
``` ```
$ make $ make
... ...
env GO111MODULE=on go build -tags 'assets ' -o bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx ./cmd/influx
env GO111MODULE=on go build -tags 'assets ' -o bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influxd ./cmd/influxd env GO111MODULE=on go build -tags 'assets ' -o bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influxd ./cmd/influxd
``` ```
`influxd` is the InfluxDB service. 3. Start the `influxd` service.
`influx` is the CLI management tool.
Start the service.
Logs to stdout by default:
``` ```
$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influxd $ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influxd
``` ```
`influxd` logs to stdout by default.
### Testing ### Testing
This project is built from various languages. To run test for all langauges and components use: This project is built from various languages. To run test for all languages and components use:
```bash ```bash
$ make test $ make test

19
README.md
View File

@ -7,13 +7,13 @@ The list of InfluxDB Client Libraries that are compatible with the latest versio
If you are looking for the 1.x line of releases, there are branches for each minor version as well as a `master-1.x` branch that will contain the code for the next 1.x release. The master-1.x [working branch is here](https://github.com/influxdata/influxdb/tree/master-1.x). The [InfluxDB 1.x Go Client can be found here](https://github.com/influxdata/influxdb1-client). If you are looking for the 1.x line of releases, there are branches for each minor version as well as a `master-1.x` branch that will contain the code for the next 1.x release. The master-1.x [working branch is here](https://github.com/influxdata/influxdb/tree/master-1.x). The [InfluxDB 1.x Go Client can be found here](https://github.com/influxdata/influxdb1-client).
## Installing ## Install
We have nightly and versioned Docker images, Debian packages, RPM packages, and tarballs of InfluxDB available at the [InfluxData downloads page](https://portal.influxdata.com/downloads/). We also provide the `influx` command line interface (CLI) client as a separate binary available at the same location. We have nightly and versioned Docker images, Debian packages, RPM packages, and tarballs of InfluxDB available at the [InfluxData downloads page](https://portal.influxdata.com/downloads/). We also provide the `influx` command line interface (CLI) client as a separate binary available at the same location.
If you are interested in building from source, see the [building from source](CONTRIBUTING.md#building-from-source) guide for contributors. If you are interested in building from source, see the [building from source](CONTRIBUTING.md#building-from-source) guide for contributors.
## Getting Started ## Get Started
For a complete getting started guide, please see our full [online documentation site](https://docs.influxdata.com/influxdb/latest/). For a complete getting started guide, please see our full [online documentation site](https://docs.influxdata.com/influxdb/latest/).
@ -76,7 +76,7 @@ Active Name URL Org
* default http://localhost:8086 InfluxData * default http://localhost:8086 InfluxData
``` ```
## Writing Data ## Write Data
Write to measurement `m`, with tag `v=2`, in bucket `telegraf`, which belongs to organization `InfluxData`: Write to measurement `m`, with tag `v=2`, in bucket `telegraf`, which belongs to organization `InfluxData`:
```bash ```bash
@ -106,11 +106,18 @@ Table: keys: [_start, _stop, _field, _measurement]
Use the `-r, --raw` option to return the raw flux response from the query. This is useful for moving data from one instance to another as the `influx write` command can accept the Flux response using the `--format csv` option. Use the `-r, --raw` option to return the raw flux response from the query. This is useful for moving data from one instance to another as the `influx write` command can accept the Flux response using the `--format csv` option.
## Introducing Flux ## Script with Flux
Flux is an MIT-licensed data scripting language (previously named IFQL) used for querying time series data from InfluxDB. The source for Flux is [available on GitHub](https://github.com/influxdata/flux). Learn more about Flux from [CTO Paul Dix's presentation](https://speakerdeck.com/pauldix/flux-number-fluxlang-a-new-time-series-data-scripting-language). Flux (previously named IFQL) is an open source functional data scripting language designed for querying, analyzing, and acting on data. Flux supports multiple data source types, including:
## Contributing to the Project - Time series databases (such as InfluxDB)
- Relational SQL databases (such as MySQL and PostgreSQL)
- CSV
The source for Flux is [available on GitHub](https://github.com/influxdata/flux).
To learn more about Flux, see the latest [InfluxData Flux documentation](https://docs.influxdata.com/flux/) and [CTO Paul Dix's presentation](https://speakerdeck.com/pauldix/flux-number-fluxlang-a-new-time-series-data-scripting-language).
## Contribute to the Project
InfluxDB is an [MIT licensed](LICENSE) open source project and we love our community. The fastest way to get something fixed is to open a PR. Check out our [contributing](CONTRIBUTING.md) guide if you're interested in helping out. Also, join us on our [Community Slack Workspace](https://influxdata.com/slack) if you have questions or comments for our engineering teams. InfluxDB is an [MIT licensed](LICENSE) open source project and we love our community. The fastest way to get something fixed is to open a PR. Check out our [contributing](CONTRIBUTING.md) guide if you're interested in helping out. Also, join us on our [Community Slack Workspace](https://influxdata.com/slack) if you have questions or comments for our engineering teams.