Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/turbot/flowpipe-mod-aws
AWS pipeline library for the Flowpipe cloud scripting engine. Automation and workflows to connect AWS to the people, systems and data that matters.
https://github.com/turbot/flowpipe-mod-aws
automation aws aws-cli cloud devops flowpipe flowpipe-mod integrations low-code orchestration pipelines security workflow workflow-automation workflow-engine
Last synced: 3 months ago
JSON representation
AWS pipeline library for the Flowpipe cloud scripting engine. Automation and workflows to connect AWS to the people, systems and data that matters.
- Host: GitHub
- URL: https://github.com/turbot/flowpipe-mod-aws
- Owner: turbot
- License: apache-2.0
- Created: 2023-10-16T03:12:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-10T07:41:19.000Z (10 months ago)
- Last Synced: 2024-04-14T01:01:38.814Z (10 months ago)
- Topics: automation, aws, aws-cli, cloud, devops, flowpipe, flowpipe-mod, integrations, low-code, orchestration, pipelines, security, workflow, workflow-automation, workflow-engine
- Language: HCL
- Homepage: https://hub.flowpipe.io/mods/turbot/aws
- Size: 474 KB
- Stars: 6
- Watchers: 7
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# AWS Mod for Flowpipe
AWS pipeline library for [Flowpipe](https://flowpipe.io), enabling seamless integration of AWS services into your workflows.
## Documentation
- **[Pipelines →](https://hub.flowpipe.io/mods/turbot/aws/pipelines)**
## Getting Started
### Requirements
Docker daemon must be installed and running. Please see [Install Docker Engine](https://docs.docker.com/engine/install/) for more information.
### Installation
Download and install Flowpipe (https://flowpipe.io/downloads). Or use Brew:
```sh
brew tap turbot/tap
brew install flowpipe
```
### Connections
By default, the following environment variables will be used for authentication:
- `AWS_PROFILE`
- `AWS_ACCESS_KEY_ID`
- `AWS_SECRET_ACCESS_KEY`
You can also create `connection` resources in configuration files:
```sh
vi ~/.flowpipe/config/aws.fpc
```
```hcl
connection "aws" "aws_profile" {
profile = "my-profile"
}
connection "aws" "aws_access_key_pair" {
access_key = "AKIA..."
secret_key = "dP+C+J..."
}
connection "aws" "aws_session_token" {
access_key = "AKIA..."
secret_key = "dP+C+J..."
session_token = "AQoDX..."
}
```
For more information on connections in Flowpipe, please see [Managing Connections](https://flowpipe.io/docs/run/connections).
### Usage
[Initialize a mod](https://flowpipe.io/docs/build/index#initializing-a-mod):
```sh
mkdir my_mod
cd my_mod
flowpipe mod init
```
[Install the AWS mod](https://flowpipe.io/docs/build/mod-dependencies#mod-dependencies) as a dependency:
```sh
flowpipe mod install github.com/turbot/flowpipe-mod-aws
```
[Use the dependency](https://flowpipe.io/docs/build/write-pipelines/index) in a pipeline step:
```sh
vi my_pipeline.fp
```
```hcl
pipeline "my_pipeline" {
step "pipeline" "describe_ec2_instances" {
pipeline = aws.pipeline.describe_ec2_instances
args = {
instance_type = "t2.micro"
region = "us-east-1"
}
}
}
```
[Run the pipeline](https://flowpipe.io/docs/run/pipelines):
```sh
flowpipe pipeline run my_pipeline
```
### Developing
Clone:
```sh
git clone https://github.com/turbot/flowpipe-mod-aws.git
cd flowpipe-mod-aws
```
List pipelines:
```sh
flowpipe pipeline list
```
Run a pipeline:
```sh
flowpipe pipeline run describe_ec2_instances --arg 'instance_ids=["i-1234567890abcdef0", "i-abcdef12345"]' --arg instance_type=t2.micro --arg region=ap-south-1
```
To use a specific `connection`, specify the `conn` pipeline argument:
```sh
flowpipe pipeline run describe_ec2_instances --arg conn=connection.aws.aws_profile --arg instance_type=t2.micro --arg region=us-east-1
```
## Open Source & Contributing
This repository is published under the [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0). Please see our [code of conduct](https://github.com/turbot/.github/blob/main/CODE_OF_CONDUCT.md). We look forward to collaborating with you!
[Flowpipe](https://flowpipe.io) is a product produced from this open source software, exclusively by [Turbot HQ, Inc](https://turbot.com). It is distributed under our commercial terms. Others are allowed to make their own distribution of the software, but cannot use any of the Turbot trademarks, cloud services, etc. You can learn more in our [Open Source FAQ](https://turbot.com/open-source).
## Get Involved
**[Join #flowpipe on Slack →](https://flowpipe.io/community/join)**
Want to help but not sure where to start? Pick up one of the `help wanted` issues:
- [Flowpipe](https://github.com/turbot/flowpipe/labels/help%20wanted)
- [AWS Mod](https://github.com/turbot/flowpipe-mod-aws/labels/help%20wanted)