docs: Added a Quick Start Guide to README#828
docs: Added a Quick Start Guide to README#828AdamVacha wants to merge 3 commits intorenovatebot:mainfrom
Conversation
| 4. Name your secret `RENOVATE_TOKEN` and paste your PAT in the value field. | ||
| 5. Click `Add secret`. | ||
|
|
||
| ### `Step 4: Create renovate.json` |
There was a problem hiding this comment.
nope, not required step. renovate will onboard all accessable repos by default.
|
|
||
| 1. Make a new directory in your repo titled `.github/workflows`. | ||
| 2. Inside your new directory create a file `renovate.yml`. | ||
| 3. Define the workflow |
There was a problem hiding this comment.
Disable autodiscover and set repo explicit or set autodiscover filter for security reasons!
jsoref
left a comment
There was a problem hiding this comment.
Note that I really wished this was in the repository -- it would have saved me a lot of time and aggravation as I worked on preparing to write renovatebot/renovate#27346
I tried to get renovate-bot to work myself and failed miserably.
I ended up borrowing from a working instance -- and then I had to figure out how to change things:
- update the version using
vars - experiment with the meaning of
null-- see the confusing definition ofdryRunandnull - fix the configuration to actually run in my fork -- I didn't get any output that hinted to me that this was a problem, which made me 😢.
| ## Quick Start | ||
|
|
||
| ### `Step 1: Renovate Explained` | ||
| Renovate is a nifty tool for automatically updating your projects dependencies so you don't have to manually! Lets go through how to setup a GitHub Action for Renovate. |
There was a problem hiding this comment.
| Renovate is a nifty tool for automatically updating your projects dependencies so you don't have to manually! Lets go through how to setup a GitHub Action for Renovate. | |
| Renovate is a nifty tool for automatically updating your projects dependencies so you don't have to manually! Let's go through how to set up a GitHub Action for Renovate. |
| We must generate a PAT for Renovate in order for it to be able to interact with your GitHub. | ||
|
|
||
| 1. Go to your GitHub settings. | ||
| 2. Navigate to Developer settings (the very bottom) and then select Personal access tokens (Tokens (classic)). |
There was a problem hiding this comment.
You could link directly to
Generate new token (classic)
and
Generate new token, Fine-grained/repo-scoped
Note that both work.
There was a problem hiding this comment.
this should link to https://docs.renovatebot.com/modules/platform/github/ there as some more about auth for github.
but you can also use the action to run agains other platforms 😉
| "extends": ["config:base"] | ||
| } | ||
| ``` | ||
| ### `Step 5: Set Up GitHub Action Workflow` |
There was a problem hiding this comment.
| ### `Step 5: Set Up GitHub Action Workflow` | |
| ### `Step 5: Set Up GitHub Action Workflow` |
|
|
||
| ## Quick Start | ||
|
|
||
| ### `Step 1: Renovate Explained` |
| ### `Step 1: Renovate Explained` | ||
| Renovate is a nifty tool for automatically updating your projects dependencies so you don't have to manually! Lets go through how to setup a GitHub Action for Renovate. | ||
|
|
||
| ### `Step 2: Generate Personal Access Token (PAT)` |
There was a problem hiding this comment.
I'm not sure I'd number the steps. I think it's better to just have an outline that links to named steps
Generate Personal Access Token (PAT)
-- I also wouldn't use backticks around these things.
|
|
||
| ``` | ||
|
|
||
| this sets up your workflow to run at 3am daily (editable) which is when Renovate will check your dependencies for updates. |
There was a problem hiding this comment.
| this sets up your workflow to run at 3am daily (editable) which is when Renovate will check your dependencies for updates. | |
| This sets up your workflow to run at 3am daily (editable) which is when Renovate will check your dependencies for updates. |
There was a problem hiding this comment.
Thank you so much for the suggestions guys! I will follow them all and update my PR when I'm back from vacation next week.
| | <a href="https://renovatebot.com"><img alt="Renovate enabled" src="https://img.shields.io/badge/renovate-enabled-brightgreen.svg?style=flat-square"></a> | Dependencies | Renovate | | ||
| | <a href="https://github.com/renovatebot/github-action/actions"><img alt="GitHub workflow status" src="https://img.shields.io/github/actions/workflow/status/renovatebot/github-action/build.yml?style=flat-square"></a> | Build | GitHub Actions | | ||
|
|
||
| ## Quick Start |
There was a problem hiding this comment.
As noted, it might be worth adding the word GitHub here -- possibly with other words (Workflow, "using a"?)
| ## Quick Start | |
| ## Quick Start with a GitHub Workflow |
|
Marked as draft due to inactivity. |
While going through the documentation for setting up GitHub-action for Renovate I noticed there wasn't a very newbie friendly quick-start guide. I through one together in the README.md with some easy setup and navigation.
Quick Start
Step 1: Renovate ExplainedRenovate is a nifty tool for automatically updating your projects dependencies so you don't have to manually! Lets go through how to setup a GitHub Action for Renovate.
Step 2: Generate Personal Access Token (PAT)We must generate a PAT for Renovate in order for it to be able to interact with your GitHub.
Generate new token.Generate tokenat the bottom (and save it for later).Step 3: Add Your PAT as a Secret in Your RepoNow we add the PAT you created as a secret in your GitHub repo.
New repository secret.RENOVATE_TOKENand paste your PAT in the value field.Add Secret.Step 4: Create renovate.jsonRenovate requires this .json file so lets setup a basic one.
renovate.jsonin the base of your repo.{ "$schema": "https://docs.renovatebot.com/renovate-schema.json", "extends": ["config:base"] }Step 5: Set Up GitHub Action WorkflowHere we need to setup the yaml for your Github Action Workflow.
.github/workflows.renovate.yml.this sets up your workflow to run at 3am daily (editable) which is when Renovate will check your dependencies for updates.
Steps 4 and 5 involve some simple .json and .yaml config that I could have made mistakes on.
I apologize ahead of time if either the .json or .yaml for workflow is incorrect, I'm quite new myself :)
This is supposed to be a simple setup requiring a PAT set to "RENOVATE_TOKEN" that allows user to setup a 3am daily Renovate check.
Thanks!