Downloads:
1,570
Downloads of v 0.1.72:
244
Last Update:
22 Jun 2021
Package Maintainer(s):
Software Author(s):
- Nimrod Kor
Tags:
devops cloud cloudformation serverless terraform tagging iac infrastructure-as-code cloudsecurity yor- Software Specific:
- Software Site
- Software Source
- Software Docs
- Package Specific:
- Package Source
- Package outdated?
- Package broken?
- Contact Maintainers
- Contact Site Admins
- Software Vendor?
- Report Abuse
- Download
yor
This is not the latest version of yor available.
- 1
- 2
- 3
0.1.72 | Updated: 22 Jun 2021
- Software Specific:
- Software Site
- Software Source
- Software Docs
- Package Specific:
- Package Source
- Package outdated?
- Package broken?
- Contact Maintainers
- Contact Site Admins
- Software Vendor?
- Report Abuse
- Download
Downloads:
1,570
Downloads of v 0.1.72:
244
Maintainer(s):
Software Author(s):
- Nimrod Kor
yor 0.1.72
This is not the latest version of yor available.
- 1
- 2
- 3
All Checks are Passing
3 Passing Tests
Deployment Method: Individual Install, Upgrade, & Uninstall
To install yor, run the following command from the command line or from PowerShell:
To upgrade yor, run the following command from the command line or from PowerShell:
To uninstall yor, run the following command from the command line or from PowerShell:
Deployment Method:
This applies to both open source and commercial editions of Chocolatey.
1. Enter Your Internal Repository Url
(this should look similar to https://community.chocolatey.org/api/v2/)
2. Setup Your Environment
1. Ensure you are set for organizational deployment
Please see the organizational deployment guide
2. Get the package into your environment
Option 1: Cached Package (Unreliable, Requires Internet - Same As Community)-
Open Source or Commercial:
- Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2/. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
- You can also just download the package and push it to a repository Download
-
Open Source
-
Download the package:
Download - Follow manual internalization instructions
-
-
Package Internalizer (C4B)
-
Run: (additional options)
choco download yor --internalize --version=0.1.72 --source=https://community.chocolatey.org/api/v2/
-
For package and dependencies run:
choco push --source="'INTERNAL REPO URL'"
- Automate package internalization
-
Run: (additional options)
3. Copy Your Script
choco upgrade yor -y --source="'INTERNAL REPO URL'" --version="'0.1.72'" [other options]
See options you can pass to upgrade.
See best practices for scripting.
Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.
If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:
choco upgrade yor -y --source="'INTERNAL REPO URL'" --version="'0.1.72'"
$exitCode = $LASTEXITCODE
Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
Exit 0
}
Exit $exitCode
- name: Install yor
win_chocolatey:
name: yor
version: '0.1.72'
source: INTERNAL REPO URL
state: present
See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.
chocolatey_package 'yor' do
action :install
source 'INTERNAL REPO URL'
version '0.1.72'
end
See docs at https://docs.chef.io/resource_chocolatey_package.html.
cChocoPackageInstaller yor
{
Name = "yor"
Version = "0.1.72"
Source = "INTERNAL REPO URL"
}
Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.
package { 'yor':
ensure => '0.1.72',
provider => 'chocolatey',
source => 'INTERNAL REPO URL',
}
Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.
4. If applicable - Chocolatey configuration/installation
See infrastructure management matrix for Chocolatey configuration elements and examples.
This package was approved by moderator jpruskin on 23 Jun 2021.
Extensible auto-tagger for your IaC files. The ultimate way to link entities in the cloud back to the codified resource which created it.
<img src="https://raw.githubusercontent.com/bridgecrewio/yor/master/docs/yor-logo.png?" width="350">
[![Maintained by Bridgecrew.io](https://img.shields.io/badge/maintained%20by-bridgecrew.io-blueviolet)](https://bridgecrew.io/?utm_source=github&utm_medium=organic_oss&utm_campaign=yor)
![golangci-lint](https://github.com/bridgecrewio/yor/workflows/tests/badge.svg)
[![security](https://github.com/bridgecrewio/yor/actions/workflows/security.yml/badge.svg)](https://github.com/bridgecrewio/yor/actions/workflows/security.yml)
<a href='https://github.com/jpoles1/gopherbadger' target='_blank'>![gopherbadger-tag-do-not-edit](https://img.shields.io/badge/Go%20Coverage-81%25-brightgreen.svg?longCache=true&style=flat)</a>
[![slack-community](https://slack.bridgecrew.io/badge.svg)](https://slack.bridgecrew.io/?utm_source=github&utm_medium=organic_oss&utm_campaign=yor)
[![Go Report Card](https://goreportcard.com/badge/github.com/bridgecrewio/yor)](https://goreportcard.com/report/github.com/bridgecrewio/yor)
[![Go Reference](https://pkg.go.dev/badge/github.com/bridgecrewio/yor.svg)](https://pkg.go.dev/github.com/bridgecrewio/yor)
[![Docker pulls](https://img.shields.io/docker/pulls/bridgecrew/yor.svg)](https://hub.docker.com/r/bridgecrew/yor)
[![GitHub All Releases](https://img.shields.io/github/downloads/bridgecrewio/yor/total)](https://github.com/bridgecrewio/yor/releases)
Yor is an open-source tool that helps add informative and consistent tags across infrastructure-as-code frameworks such as Terraform, CloudFormation, and Serverless.
Yor is built to run as a [GitHub Action](https://github.com/bridgecrewio/yor-action) automatically adding consistent tagging logics to your IaC. Yor can also run as a pre-commit hook and a standalone CLI.
## Features
* Apply tags and labels on infrastructure as code directory
* Tracing: ```yor_trace``` tag enables simple attribution between an IaC resource block and a running cloud resource.
* Change management: git-based tags automatically add org, repo, commit and modifier details on every resource block.
* Custom taggers: user-defined tagging logics can be added to run using Yor.
* Skips: inline annotations enable developers to exclude paths that should not be tagged.
## Demo
[![](docs/yor_tag_and_trace_recording.gif)](https://raw.githubusercontent.com/bridgecrewio/yor/main/docs/yor_tag_and_trace_recording.gif)
<!-- ### Attributing a directory with tags by user input
[![](docs/yor_terragoat_simple.gif)](https://raw.githubusercontent.com/bridgecrewio/yor/main/docs/yor_terragoat_simple.gif)
### Attributing a resource to an owner
[![](docs/yor_owner.gif)](https://raw.githubusercontent.com/bridgecrewio/yor/main/docs/yor_owner.gif)
### Change management tags
[![](docs/yor_git_tags.gif)](https://raw.githubusercontent.com/bridgecrewio/yor/main/docs/yor_git_tags.gif)
### Trace IaC code to cloud resource
[![](docs/yor_trace.gif)](https://raw.githubusercontent.com/bridgecrewio/yor/main/docs/yor_trace.gif)
### Trace cloud resource to IaC code
[![](docs/yor_file.gif)](https://raw.githubusercontent.com/bridgecrewio/yor/main/docs/yor_file.gif) -->
## **Table of contents**
- [Getting Started](#getting-started)
- [Support](#support)
- [Customizing Yor](CUSTOMIZE.md)
## Getting Started
### Installation
MacOS / Linux
```sh
brew tap bridgecrewio/tap
brew install bridgecrewio/tap/yor
```
__OR__
Windows
```sh
choco install yor
```
__OR__
Docker
```sh
docker pull bridgecrew/yor
docker run --tty --volume /local/path/to/tf:/tf bridgecrew/yor tag --directory /tf
```
GitHub Action
```yaml
name: IaC trace
on:
# Triggers the workflow on push or pull request events but only for the main branch
push:
branches: [ main ]
pull_request:
branches: [ main ]
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
jobs:
yor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
name: Checkout repo
with:
fetch-depth: 0
ref: ${{ github.head_ref }}
- name: Run yor action and commit
uses: bridgecrewio/yor-action@main
```
Pre-commit
```yaml
- repo: git://github.com/bridgecrewio/yor
rev: 0.0.44
hooks:
- id: yor
name: yor
entry: yor tag -d
args: ["example/examplea"]
language: golang
types: [terraform]
pass_filenames: false
```
### Usage
`tag` : Apply tagging on a given directory.
```sh
# Apply all the tags in yor on the directory tree terraform.
yor tag --directory terraform/
# Apply all the tags in yor except the tags git_last_modified_by and yor_trace.
yor tag --directory terraform/ --skip-tags git_last_modified_by,yor_trace
# Apply only the tags under the git tag group.
yor tag --tag-groups git --directory terraform/
# Apply key-value tags on a specific directory
export YOR_SIMPLE_TAGS='{ "Environment" : "Dev" }'
yor tag --tag-groups simple --directory terraform/dev/
```
`-o` : Modify output formats.
```sh
yor tag -d . -o cli
# default cli output
yor tag -d . -o json
# json output
yor tag -d . --output cli --output-json-file result.json
# print cli output and additional output to file on json file -- enables programmatic analysis alongside printing human readable result
```
`--skip-tags`: Specify only named tags (allow list) or run all tags except those listed (deny list).
```sh
yor tag -d . --skip-tags yor_trace
## Run all but yor_trace
yor tag -d . --skip-tags yor_trace,git_modifiers
## Run all but yor_trace and git_modifiers
yor tag -d . --skip-tags git*
## Run all tags except tags with specified patterns
```
`skip-dirs` : Skip directory paths you can define paths that will not be tagged.
```sh
yor tag -d path/to/files
## Run on the directory path/to/files
yor tag -d path/to/files --skip-dirs path/to/files/skip,path/to/files/another/skip2
## Run yor on the directory path/to/files, skipping path/to/files/skip/ and path/to/files/another/skip2/
```
`list-tag`
```sh
yor list-tag-groups
# List tag classes that are built into yor.
yor list-tags
# List all the tags built into yor
yor list-tags --tag-groups git
# List all the tags built into yor under the tag group git
```
### What is Yor trace?
yor_trace is a magical tag creating a unique identifier for an IaC resource code block.
Having a yor_trace in place can help with tracing code block to its cloud provisioned resources without access to sensitive data such as plan or state files.
See demo [here](#Trace-IaC-code-to-cloud-resource)
## Contributing
Contribution is welcomed!
We are working on extending Yor and adding more parsers (to support additional IaC frameworks) and more taggers (to tag using other contextual data).
To maintain our conventions, please run lint on your branch before opening a PR. To run lint:
```sh
golangci-lint run --fix --skip-dirs tests/yor_plugins
```
## Support
For more support contact us at https://slack.bridgecrew.io/.
VERIFICATION
Verification is intended to assist the Chocolatey moderators and community
in verifying that this package's contents are trustworthy.
The original zip and extracted exe are downloaded from the Github Release e.g.:
https://github.com/bridgecrewio/yor/releases/tag/0.1.53
<Include details of how to verify checksum contents>
This open source tools is made by Us/Bridgecrew.
md5: AC9FA77E2CAAC1A6E008CC389A3DFA1C | sha1: AAFBBED3E1FA3CFC891AE5DC624E16ACC2539D82 | sha256: 01E4498526071988529A809B8F42A20D455451D862A85DC942DAA4FA17BCDE09 | sha512: 50DFE07F7F1FB13D885D34D2026C48EBB48D0D96E75E0B9ED88AAAD735A83CB31A5B33A6F061B07DB1ADF9C061BCA9C823FE2B0EBB1AC717D447CE30C720D10D
Log in or click on link to see number of positives.
- yor.0.1.72.nupkg (f2d88166d98f) - ## / 62
- yor.exe (01e449852607) - ## / 66
In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).
Chocolatey Pro provides runtime protection from possible malware.
Add to Builder | Version | Downloads | Last Updated | Status |
---|---|---|---|---|
yor 0.1.194 | 13 | Wednesday, May 1, 2024 | Approved | |
yor 0.1.193 | 11 | Tuesday, April 30, 2024 | Approved | |
yor 0.1.192 | 14 | Thursday, April 25, 2024 | Approved | |
yor 0.1.191 | 40 | Monday, March 11, 2024 | Approved | |
yor 0.1.190 | 20 | Thursday, March 7, 2024 | Approved | |
yor 0.1.189 | 23 | Wednesday, February 14, 2024 | Approved | |
yor 0.1.188 | 33 | Tuesday, January 9, 2024 | Approved | |
yor 0.1.187 | 27 | Sunday, December 17, 2023 | Approved | |
yor 0.1.185 | 58 | Wednesday, August 30, 2023 | Approved | |
yor 0.1.184 | 31 | Monday, August 28, 2023 | Approved | |
yor 0.1.183 | 61 | Monday, July 17, 2023 | Approved | |
yor 0.1.182 | 35 | Wednesday, July 12, 2023 | Approved | |
yor 0.1.181 | 32 | Monday, July 10, 2023 | Approved | |
yor 0.1.180 | 66 | Thursday, June 8, 2023 | Approved | |
yor 0.1.179 | 39 | Tuesday, June 6, 2023 | Approved | |
yor 0.1.178 | 39 | Tuesday, May 23, 2023 | Approved | |
yor 0.1.177 | 35 | Thursday, May 18, 2023 | Approved | |
yor 0.1.176 | 34 | Thursday, May 18, 2023 | Approved | |
yor 0.1.175 | 41 | Sunday, May 14, 2023 | Approved | |
yor 0.1.174 | 46 | Sunday, April 30, 2023 | Approved | |
yor 0.1.173 | 28 | Thursday, April 27, 2023 | Approved | |
yor 0.1.171 | 59 | Wednesday, March 22, 2023 | Approved | |
yor 0.1.170 | 32 | Wednesday, March 1, 2023 | Approved | |
yor 0.1.169 | 40 | Tuesday, February 21, 2023 | Approved | |
yor 0.1.168 | 39 | Thursday, February 16, 2023 | Approved | |
yor 0.1.167 | 32 | Wednesday, February 15, 2023 | Approved | |
yor 0.1.72 | 244 | Tuesday, June 22, 2021 | Approved |
2021 Bridgecrew
This package has no dependencies.
Ground Rules:
- This discussion is only about yor and the yor package. If you have feedback for Chocolatey, please contact the Google Group.
- This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
- The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
- Tell us what you love about the package or yor, or tell us what needs improvement.
- Share your experiences with the package, or extra configuration or gotchas that you've found.
- If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.