Skip to content

Commit

Permalink
Merge pull request #255 from microsoft/staging
Browse files Browse the repository at this point in the history
Release - 10/30/23 (Not actual release, verifying new build pipelines)
  • Loading branch information
EricJohnson327 authored Oct 30, 2023
2 parents 4ffb4bc + 546574e commit 78b00f3
Show file tree
Hide file tree
Showing 9 changed files with 2,627 additions and 477 deletions.
26 changes: 10 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,7 @@
![image](https://github.com/microsoft/devhomegithubextension/blob/main/src/GithubPluginServer/Assets/StoreDisplay-150.png)
![image](https://github.com/microsoft/devhomegithubextension/blob/main/src/GitHubExtensionServer/Assets/StoreDisplay-150.png)

# Welcome to the Dev Home GitHub Extension repo


This repository contains the source code for:

* [Dev Home GitHub Extension](https://aka.ms/devhomegithubextension)
Expand All @@ -16,14 +15,12 @@ Related repositories include:

> **Note**: The Dev Home GitHub Extension requires Dev Home. Dev Home requires Windows 11 21H2 (build 22000) or later.
### Microsoft Store [Recommended]

Install [Dev Home from the Microsoft Store](https://aka.ms/devhome) and the Dev Home GitHub Extension will automatically be installed on first launch of Dev Home.
This allows you to always be on the latest version when we release new builds with automatic upgrades.
### Dev Home Extensions library [Recommended]
You can install the Dev Home GitHub Extension from the Extensions library within Dev Home. This page can be found in the left-hand navigation pane. The list of available extensions will provide links to install from the store.

This is our preferred method.
### Microsoft Store

You can also install the Dev Home GitHub Extension from its own [Microsoft Store listing](https://aka.ms/devhomegithubextension).
You can also install the Dev Home GitHub Extension directly from its [Microsoft Store listing](https://aka.ms/devhomegithubextension).

### Other install methods

Expand All @@ -39,11 +36,11 @@ Please take a few minutes to review the overview below before diving into the co

### Widgets

The Dev Home GitHub Extension provides widgets for Dev Home's dashboard, which is built as a Windows widget renderer. These widgets are built using the Windows widget platform, which relies on Adaptive Cards.
The Dev Home GitHub Extension provides widgets for Dev Home's dashboard, which is built as a Windows widget renderer. These widgets are built using the [Windows widget platform](https://learn.microsoft.com/windows/apps/design/widgets/), which relies on [Adaptive Cards](https://learn.microsoft.com/windows/apps/design/widgets/widgets-create-a-template).

### Machine configuration repository recommendations

The machine configuration tool utilizes the Dev Home GitHub Extension to recommend repositories to clone, but isn't required to clone and install apps. The app installation tool is powered by winget.
The machine configuration tool utilizes the Dev Home GitHub Extension to recommend repositories to clone, but isn't required to clone and install apps. The app installation tool is powered by [winget](https://learn.microsoft.com/windows/package-manager/winget).

---

Expand All @@ -67,9 +64,8 @@ Please file new issues, feature requests and suggestions, but **DO search for si

If you would like to ask a question that you feel doesn't warrant an issue (yet), please reach out to us via Twitter:

* Kayla Cinnamon, Product Manager: [@cinnamon_msft](https://twitter.com/cinnamon_msft)
* Clint Rutkas, Senior Product Manager: [@crutkas](https://twitter.com/crutkas)
* Ujjwal Chadha, Developer: [@ujjwalscript](https://twitter.com/ujjwalscript)
* Kayla Cinnamon, Senior Product Manager: [@cinnamon_msft](https://twitter.com/cinnamon_msft)
* Clint Rutkas, Principal Product Manager: [@clintrutkas](https://twitter.com/clintrutkas)

## Developer guidance

Expand All @@ -80,7 +76,7 @@ If you would like to ask a question that you feel doesn't warrant an issue (yet)

* Clone the repository
* Uninstall the Preview version of the Dev Home GitHub Extension (Dev Home has a hard time choosing which extension to use if two versions exist)
* Open the GITServices.sln in Visual Studio 2022 or later, and build from the IDE, or run build.ps1 from a Visual Studio command prompt.
* Open `GitHubExtension.sln` in Visual Studio 2022 or later and build from the IDE, or run `build\scripts\build.ps1` from a Visual Studio command prompt.

### OAuth App
Since secrets cannot be checked in to the repository, developers must create their own test OAuth app for local tests.
Expand All @@ -89,8 +85,6 @@ Follow this link https://docs.github.com/en/developers/apps/building-oauth-apps/

The OAuth App ClientId and ClientSecret can be added as environment variables using the following instructions:

How to set the environment variables:

On an elevated cmd window:
setx GITHUB_CLIENT_ID "Your OAuth App's ClientId" /m
setx GITHUB_CLIENT_SECRET "Your OAuth App's ClientSecret" /m
Expand Down
56 changes: 38 additions & 18 deletions build/SyncMirroredRepository.yml
Original file line number Diff line number Diff line change
@@ -1,18 +1,38 @@
jobs:
- job: SyncMirror
dependsOn: []
pool:
vmImage: 'windows-latest'
steps:
- task: AzureKeyVault@1
inputs:
azureSubscription: 'DevHomeAzureServiceConnection'
KeyVaultName: 'DevHomeKeyVault'
SecretsFilter: 'GitHubPAT'
RunAsPreJob: false

- template: SyncMirror-Steps.yml
parameters:
SourceRepository: "https://$(GitHubPAT)@github.com/microsoft/DevHomeGitHubExtension.git"
TargetBranch: "$(SourceToTargetBranch)"
SourceBranch: "$(SourceToTargetBranch)"
resources:
repositories:
- repository: m365Pipelines
type: git
name: 1ESPipelineTemplates/M365GPT
ref: refs/tags/release
extends:
template: v1/M365.Official.PipelineTemplate.yml@m365Pipelines
parameters:
sdl:
roslyn:
enabled: true
arrow:
serviceConnection: DevHome Build VM Generation
pool:
name: Azure-Pipelines-1ESPT-ExDShared
image: windows-2022
os: windows
customBuildTags:
- ES365AIMigrationTooling
stages:
- stage: SyncMirror
jobs:
- job: SyncMirror
dependsOn: []
steps:
- task: AzureKeyVault@1
inputs:
azureSubscription: 'DevHomeAzureServiceConnection'
KeyVaultName: 'DevHomeKeyVault'
SecretsFilter: 'GitHubPAT'
RunAsPreJob: false

- template: /build/SyncMirror-Steps.yml@self
parameters:
SourceRepository: "https://$(GitHubPAT)@github.com/microsoft/DevHomeGitHubExtension.git"
TargetBranch: "$(SourceToTargetBranch)"
SourceBranch: "$(SourceToTargetBranch)"
Loading

0 comments on commit 78b00f3

Please sign in to comment.