Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve preview build instructions for Yarn v3 #1481

Merged
merged 4 commits into from
Jul 13, 2023

Conversation

Gudahtt
Copy link
Member

@Gudahtt Gudahtt commented Jul 11, 2023

Explanation

The preview build Yarn v3 instructions have been updated to suggest a new workflow that no longer requires users to make changes to .yarnrc.yml without committing them. The new workflow lets users enable/disable preview builds with one environment variable, and lets them setup authentication with another.

This workflow avoids the risk of users accidentally committing secrets. It's also easier to setup in CI.

This workflow was inspired by the process documented in the snaps monorepo. A tip about using the macOS keychain was also ported directly from that documentation.

Additionally, documentation has been reorganized so that the "MetaMask contributor" and "independent contributor" instructions only differ for publishing (the steps for using preview builds are the same for both). Separating the instructions for publishing preview builds v.s. using them seemed to make more sense to me anyway.

Changelog

N/A, documentation only

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've highlighted breaking changes using the "BREAKING" category above as appropriate

docs/contributing.md Outdated Show resolved Hide resolved
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 11, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 11, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
@Gudahtt Gudahtt force-pushed the improve-yarn-v3-preview-build-setup-instructions branch from cdc18c8 to 50ea6e1 Compare July 11, 2023 22:37
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 11, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 11, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 11, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 12, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 12, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 12, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 12, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 12, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
@Gudahtt Gudahtt marked this pull request as ready for review July 12, 2023 22:12
@Gudahtt Gudahtt requested a review from a team as a code owner July 12, 2023 22:12
The preview build Yarn v3 instructions have been updated to suggest a
new workflow that no longer requires users to make changes to
`.yarnrc.yml` without committing them. The new workflow lets users
enable/disable preview builds with one environment variable, and lets
them setup authentication with another.

This workflow avoids the risk of users accidentally committing secrets.
It's also easier to setup in CI.

This workflow was inspired by the process documented in the snaps
monorepo. A tip about using the macOS keychain was also ported directly
from that documentation.
@Gudahtt Gudahtt force-pushed the improve-yarn-v3-preview-build-setup-instructions branch from 846e888 to 9d88af2 Compare July 12, 2023 22:12
Gudahtt added a commit to MetaMask/metamask-extension that referenced this pull request Jul 12, 2023
Preview builds were setup to install correctly on CircleCI prior to
the Yarn v3 upgrade, but that integration broke with that upgrade. The
Yarn and CircleCI configuration has been updated to fix this.

The `.yarnrc.yaml` file has been updated to configure the GitHub
registry but leave it disabled by default. It can be enabled
dynamically using an environment variable. This lets us switch between
registries without updating the file.

The new workflow is documented here: MetaMask/core#1481
@Gudahtt Gudahtt force-pushed the improve-yarn-v3-preview-build-setup-instructions branch from 335daed to ee6b467 Compare July 13, 2023 15:07
mcmire
mcmire previously approved these changes Jul 13, 2023
Copy link
Contributor

@mcmire mcmire left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks much improved, nicely done. Just had a minor comment but it's non-blocking.

docs/contributing.md Outdated Show resolved Hide resolved
Co-authored-by: Elliot Winkler <elliot.winkler@gmail.com>
@Gudahtt Gudahtt merged commit 4cb2bda into main Jul 13, 2023
91 checks passed
@Gudahtt Gudahtt deleted the improve-yarn-v3-preview-build-setup-instructions branch July 13, 2023 19:00
MajorLift pushed a commit that referenced this pull request Oct 11, 2023
* Improve preview build instructions for Yarn v3

The preview build Yarn v3 instructions have been updated to suggest a
new workflow that no longer requires users to make changes to
`.yarnrc.yml` without committing them. The new workflow lets users
enable/disable preview builds with one environment variable, and lets
them setup authentication with another.

This workflow avoids the risk of users accidentally committing secrets.
It's also easier to setup in CI.

This workflow was inspired by the process documented in the snaps
monorepo. A tip about using the macOS keychain was also ported directly
from that documentation.

* Recommend setting the registry inline

* Simplify preview build instructions

* Improve description of shell command example

Co-authored-by: Elliot Winkler <elliot.winkler@gmail.com>

---------

Co-authored-by: Elliot Winkler <elliot.winkler@gmail.com>
MajorLift pushed a commit that referenced this pull request Oct 11, 2023
* Improve preview build instructions for Yarn v3

The preview build Yarn v3 instructions have been updated to suggest a
new workflow that no longer requires users to make changes to
`.yarnrc.yml` without committing them. The new workflow lets users
enable/disable preview builds with one environment variable, and lets
them setup authentication with another.

This workflow avoids the risk of users accidentally committing secrets.
It's also easier to setup in CI.

This workflow was inspired by the process documented in the snaps
monorepo. A tip about using the macOS keychain was also ported directly
from that documentation.

* Recommend setting the registry inline

* Simplify preview build instructions

* Improve description of shell command example

Co-authored-by: Elliot Winkler <elliot.winkler@gmail.com>

---------

Co-authored-by: Elliot Winkler <elliot.winkler@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants