<!--
# -*- mode: jinja -*-
-->

About aws-iam-authenticator
===========================

Home: https://github.com/kubernetes-sigs/aws-iam-authenticator

Package license: Apache 2.0

Feedstock license: BSD 3-Clause

Summary: A tool to use AWS IAM credentials to authenticate to a Kubernetes cluster

If you are an administrator running a Kubernetes cluster on AWS, you already
need to manage AWS IAM credentials to provision and update the cluster. By using
AWS IAM Authenticator for Kubernetes, you avoid having to manage a separate
credential for Kubernetes access. AWS IAM also provides a number of nice
properties such as an out of band audit trail (via CloudTrail) and 2FA/MFA enforcement.

If you are building a Kubernetes installer on AWS, AWS IAM Authenticator for
Kubernetes can simplify your bootstrap process. You won't need to somehow
smuggle your initial admin credential securely out of your newly installed
cluster. Instead, you can create a dedicated KubernetesAdmin role at cluster
provisioning time and set up Authenticator to allow cluster administrator logins.


Current build status
====================

[![Linux](https://img.shields.io/circleci/project/github/conda-forge/aws-iam-authenticator-feedstock/master.svg?label=Linux)](https://circleci.com/gh/conda-forge/aws-iam-authenticator-feedstock)
[![OSX](https://img.shields.io/travis/conda-forge/aws-iam-authenticator-feedstock/master.svg?label=macOS)](https://travis-ci.org/conda-forge/aws-iam-authenticator-feedstock)
[![Windows](https://img.shields.io/appveyor/ci/conda-forge/aws-iam-authenticator-feedstock/master.svg?label=Windows)](https://ci.appveyor.com/project/conda-forge/aws-iam-authenticator-feedstock/branch/master)

Current release info
====================

| Name | Downloads | Version | Platforms |
| --- | --- | --- | --- |
| [![Conda Recipe](https://img.shields.io/badge/recipe-aws--iam--authenticator-green.svg)](https://anaconda.org/conda-forge/aws-iam-authenticator) | [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/aws-iam-authenticator.svg)](https://anaconda.org/conda-forge/aws-iam-authenticator) | [![Conda Version](https://img.shields.io/conda/vn/conda-forge/aws-iam-authenticator.svg)](https://anaconda.org/conda-forge/aws-iam-authenticator) | [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/aws-iam-authenticator.svg)](https://anaconda.org/conda-forge/aws-iam-authenticator) |

Installing aws-iam-authenticator
================================

Installing `aws-iam-authenticator` from the `conda-forge` channel can be achieved by adding `conda-forge` to your channels with:

```
conda config --add channels conda-forge
```

Once the `conda-forge` channel has been enabled, `aws-iam-authenticator` can be installed with:

```
conda install aws-iam-authenticator
```

It is possible to list all of the versions of `aws-iam-authenticator` available on your platform with:

```
conda search aws-iam-authenticator --channel conda-forge
```


About conda-forge
=================

[![Powered by NumFOCUS](https://img.shields.io/badge/powered%20by-NumFOCUS-orange.svg?style=flat&colorA=E1523D&colorB=007D8A)](http://numfocus.org)

conda-forge is a community-led conda channel of installable packages.
In order to provide high-quality builds, the process has been automated into the
conda-forge GitHub organization. The conda-forge organization contains one repository
for each of the installable packages. Such a repository is known as a *feedstock*.

A feedstock is made up of a conda recipe (the instructions on what and how to build
the package) and the necessary configurations for automatic building using freely
available continuous integration services. Thanks to the awesome service provided by
[CircleCI](https://circleci.com/), [AppVeyor](https://www.appveyor.com/)
and [TravisCI](https://travis-ci.org/) it is possible to build and upload installable
packages to the [conda-forge](https://anaconda.org/conda-forge)
[Anaconda-Cloud](https://anaconda.org/) channel for Linux, Windows and OSX respectively.

To manage the continuous integration and simplify feedstock maintenance
[conda-smithy](https://github.com/conda-forge/conda-smithy) has been developed.
Using the ``conda-forge.yml`` within this repository, it is possible to re-render all of
this feedstock's supporting files (e.g. the CI configuration files) with ``conda smithy rerender``.

For more information please check the [conda-forge documentation](https://conda-forge.org/docs/).

Terminology
===========

**feedstock** - the conda recipe (raw material), supporting scripts and CI configuration.

**conda-smithy** - the tool which helps orchestrate the feedstock.
                   Its primary use is in the construction of the CI ``.yml`` files
                   and simplify the management of *many* feedstocks.

**conda-forge** - the place where the feedstock and smithy live and work to
                  produce the finished article (built conda distributions)


Updating aws-iam-authenticator-feedstock
========================================

If you would like to improve the aws-iam-authenticator recipe or build a new
package version, please fork this repository and submit a PR. Upon submission,
your changes will be run on the appropriate platforms to give the reviewer an
opportunity to confirm that the changes result in a successful build. Once
merged, the recipe will be re-built and uploaded automatically to the
`conda-forge` channel, whereupon the built conda packages will be available for
everybody to install and use from the `conda-forge` channel.
Note that all branches in the conda-forge/aws-iam-authenticator-feedstock are
immediately built and any created packages are uploaded, so PRs should be based
on branches in forks and branches in the main repository should only be used to
build distinct package versions.

In order to produce a uniquely identifiable distribution:
 * If the version of a package **is not** being increased, please add or increase
   the [``build/number``](https://conda.io/docs/user-guide/tasks/build-packages/define-metadata.html#build-number-and-string).
 * If the version of a package **is** being increased, please remember to return
   the [``build/number``](https://conda.io/docs/user-guide/tasks/build-packages/define-metadata.html#build-number-and-string)
   back to 0.

Feedstock Maintainers
=====================

* [@edisongustavo](https://github.com/edisongustavo/)