1. The[Github action](https://github.com/marketplace?type=actions) you have selected is Docker based and has a self-contained and valid Dockerfile

1. You have read the documentation of the Github action and know what arguments/input it requires

Also notice that since Github actions are created by the community, it is your responsibility to filter and curate any Github actions that you wish to use in Codefresh pipelines. If for example you use a Github action, and then it is removed by its creator, the Codefresh pipeline that uses it will break as well.

Codefresh offers a github-action-to-codefresh step converter. This converter has two functions

1. When you create your pipeline it will analyze the Github action and try to find what arguments it requires. You must then fill the values needed by yourself

1. When the pipeline runs, it will automatically find the Dockerfile of the Github action, build it, push it in theDocker registry that you specify and then use it as a standard Codefresh step.

1. When the pipeline runs, it will automatically find the Dockerfile of the Github action, build it and make available thedocker image in any subsequent step in the same pipeline.

All this process is automatic. You just need to make sure that all arguments/inputs of the Github action as provided using[pipeline variables]({{site.baseurl}}/docs/configure-ci-cd-pipeline/pipelines/#creating-new-pipelines),[shared configuration]({{site.baseurl}}/docs/configure-ci-cd-pipeline/shared-configuration/) or any other standard mechanism you already use in Codefresh.

{% include image.html

lightbox="true"

file="/images/integrations/github-actions/snyk-arguments.png"

url="/images/integrations/github-actions/snyk-arguments.png"

file="/images/integrations/github-actions/snyk-action-arguments.png"

url="/images/integrations/github-actions/snyk-action-arguments.png"

max-width="70%"

caption="Using the Snyk Github action"

alt="Using the Snyk Github action"

%}

This YAML snippet is a template and the following need to be filled under the`arguments` block:

This YAML snippet is a template and you need to fill the`env` block under the`arguments` block:

The required environment variables are specific to each Github action so check the documentation of the action itself.

*`env` - a list of arguments. They are specific to each Github action so check the documentation of the action itself

*`registry` - the name of a[registry connected to Codefresh]({{site.baseurl}}/docs/docker-registries/external-docker-registries/). You can find the names in your[integrations page](https://g.codefresh.io/account-admin/account-conf/integration/registry)

*`registry_repo` - the repository/account that you wish to use in the registry for storing the Github action. In the case of Dockerhub it is your Dockerhub username, for the Codefresh registry it is your Codefresh username and so on.

In the example above we are using the Snyk Github action. By visiting the[documentation page](https://github.com/marketplace/actions/snyk-cli-action) we find that this action expects a`SNYK_TOKEN` as input.

envs:

- SNYK_TOKEN: '${{SNYK_TOKEN}}'

cmd: test alpine@latest

registry: dockerhub

registry_repo: codefreshplugins

{% endraw %}

{% endhighlight %}

1. Find the Dockerfile of the Github action

1. Build the Dockerfile

1. Push the resulting image to the connected Codefresh registry

1. Take the resulting image and insert it as Codefresh step

1. Pass the environment variables as arguments to the Github action

1. Run the`cmd` command

- New variable`CF_BRANCH_TAG_NORMALIZED_LOWER_CASE` -[documentation]({{site.baseurl}}/docs/codefresh-yaml/variables/#system-provided-variables)

- Trigger a Kubernetes Deployment from a Dockerhub Push Event -[documentation]({{site.baseurl}}/docs/yaml-examples/examples/trigger-a-k8s-deployment-from-docker-registry/)

- Uploading or Downloading from a Google Storage Bucket -[documentation]({{site.baseurl}}/docs/yaml-examples/examples/uploading-or-downloading-from-gs/)

- Use Github actions no longer requires a Registry -[documentation]({{site.baseurl}}/docs/integrations/github-actions/#how-it-works)