@backstage/plugin-scaffolder-backend-module-github 0.0.0-nightly-20240701022140 → 0.0.0-nightly-20240702021736

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @backstage/plugin-scaffolder-backend-module-github
 
-## 0.0.0-nightly-20240701022140
+## 0.0.0-nightly-20240702021736
 
 ### Minor Changes
 
@@ -8,16 +8,17 @@
 
 ### Patch Changes
 
+- 141f366: Added action to enable GitHub Pages on a repo
 - 4410fed: Fixed issue with octokit call missing owner and repo when creating environment variables and secrets using github:environment:create action
 - dfaa28d: Adds `requireLastPushApproval` input property to configure Branch Protection Settings in `github:publish` action
 
   Adds `requireLastPushApproval` input property to configure Branch Protection Settings in `github:repo:push` action
 
 - Updated dependencies
-  - @backstage/backend-plugin-api@0.0.0-nightly-20240701022140
-  - @backstage/backend-common@0.0.0-nightly-20240701022140
-  - @backstage/integration@0.0.0-nightly-20240701022140
-  - @backstage/plugin-scaffolder-node@0.0.0-nightly-20240701022140
+  - @backstage/backend-plugin-api@0.0.0-nightly-20240702021736
+  - @backstage/backend-common@0.0.0-nightly-20240702021736
+  - @backstage/integration@0.0.0-nightly-20240702021736
+  - @backstage/plugin-scaffolder-node@0.0.0-nightly-20240702021736
   - @backstage/config@1.2.0
   - @backstage/errors@1.2.4
 

package/dist/index.cjs.js

@@ -12,6 +12,7 @@ var webhooks = require('@octokit/webhooks');
 var path = require('path');
 var octokitPluginCreatePullRequest = require('octokit-plugin-create-pull-request');
 var backendPluginApi = require('@backstage/backend-plugin-api');
+var pluginScaffolderBackendModuleGithub = require('@backstage/plugin-scaffolder-backend-module-github');
 var alpha = require('@backstage/plugin-scaffolder-node/alpha');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
@@ -376,7 +377,7 @@ function getGitCommitMessage(gitCommitMessage, config) {
   return gitCommitMessage ? gitCommitMessage : config.getOptionalString("scaffolder.defaultCommitMessage");
 }
 
-const examples$9 = [
+const examples$a = [
   {
     description: "GitHub Action Workflow Without Inputs.",
     example: yaml__default.default.stringify({
@@ -437,7 +438,7 @@ function createGithubActionsDispatchAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:actions:dispatch",
     description: "Dispatches a GitHub Action workflow for a given branch or tag",
-    examples: examples$9,
+    examples: examples$a,
     schema: {
       input: {
         type: "object",
@@ -506,7 +507,7 @@ function createGithubActionsDispatchAction(options) {
   });
 }
 
-const examples$8 = [
+const examples$9 = [
   {
     description: "Add labels to pull request or issue",
     example: yaml__default.default.stringify({
@@ -547,7 +548,7 @@ function createGithubIssuesLabelAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:issues:label",
     description: "Adds labels to a pull request or issue on GitHub.",
-    examples: examples$8,
+    examples: examples$9,
     schema: {
       input: {
         type: "object",
@@ -896,7 +897,7 @@ const commitHash = {
   type: "string"
 };
 
-const examples$7 = [
+const examples$8 = [
   {
     description: "Creates a GitHub repository with default configuration.",
     example: yaml__default.default.stringify({
@@ -949,7 +950,7 @@ function createGithubRepoCreateAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:repo:create",
     description: "Creates a GitHub repository.",
-    examples: examples$7,
+    examples: examples$8,
     schema: {
       input: {
         type: "object",
@@ -1059,7 +1060,7 @@ function createGithubRepoCreateAction(options) {
   });
 }
 
-const examples$6 = [
+const examples$7 = [
   {
     description: "Setup repo with no modifications to branch protection rules",
     example: yaml__default.default.stringify({
@@ -1111,7 +1112,7 @@ function createGithubRepoPushAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:repo:push",
     description: "Initializes a git repository of contents in workspace and publishes it to GitHub.",
-    examples: examples$6,
+    examples: examples$7,
     schema: {
       input: {
         type: "object",
@@ -1216,7 +1217,7 @@ function createGithubRepoPushAction(options) {
   });
 }
 
-const examples$5 = [
+const examples$6 = [
   {
     description: "Create a GitHub webhook for a repository",
     example: yaml__default.default.stringify({
@@ -1325,7 +1326,7 @@ function createGithubWebhookAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:webhook",
     description: "Creates webhook for a repository on GitHub.",
-    examples: examples$5,
+    examples: examples$6,
     supportsDryRun: true,
     schema: {
       input: {
@@ -1443,7 +1444,7 @@ function createGithubWebhookAction(options) {
   });
 }
 
-const examples$4 = [
+const examples$5 = [
   {
     description: "Example 1: Create and store a Deploy Key",
     example: yaml__default.default.stringify({
@@ -1468,7 +1469,7 @@ function createGithubDeployKeyAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:deployKey:create",
     description: "Creates and stores Deploy Keys",
-    examples: examples$4,
+    examples: examples$5,
     schema: {
       input: {
         type: "object",
@@ -1571,7 +1572,7 @@ function createGithubDeployKeyAction(options) {
   });
 }
 
-const examples$3 = [
+const examples$4 = [
   {
     description: "Create a GitHub Environment (No Policies, No Variables, No Secrets)",
     example: yaml__default.default.stringify({
@@ -1656,7 +1657,7 @@ function createGithubEnvironmentAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:environment:create",
     description: "Creates Deployment Environments",
-    examples: examples$3,
+    examples: examples$4,
     schema: {
       input: {
         type: "object",
@@ -1826,7 +1827,7 @@ function createGithubEnvironmentAction(options) {
   });
 }
 
-const examples$2 = [
+const examples$3 = [
   {
     description: "Create a pull request",
     example: yaml__default.default.stringify({
@@ -2110,7 +2111,7 @@ const createPublishGithubPullRequestAction = (options) => {
   } = options;
   return pluginScaffolderNode.createTemplateAction({
     id: "publish:github:pull-request",
-    examples: examples$2,
+    examples: examples$3,
     supportsDryRun: true,
     schema: {
       input: {
@@ -2394,7 +2395,7 @@ const createPublishGithubPullRequestAction = (options) => {
   }
 };
 
-const examples$1 = [
+const examples$2 = [
   {
     description: "Initializes a git repository with the content in the workspace, and publishes it to GitHub with the default configuration.",
     example: yaml__default.default.stringify({
@@ -2449,7 +2450,7 @@ function createPublishGithubAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "publish:github",
     description: "Initializes a git repository of contents in workspace and publishes it to GitHub.",
-    examples: examples$1,
+    examples: examples$2,
     schema: {
       input: {
         type: "object",
@@ -2616,7 +2617,7 @@ function createPublishGithubAction(options) {
   });
 }
 
-const examples = [
+const examples$1 = [
   {
     description: "GitHub alphanumric autolink reference",
     example: yaml__default.default.stringify({
@@ -2641,7 +2642,7 @@ function createGithubAutolinksAction(options) {
   return pluginScaffolderNode.createTemplateAction({
     id: "github:autolinks:create",
     description: "Create an autolink reference for a repository",
-    examples,
+    examples: examples$1,
     schema: {
       input: {
         type: "object",
@@ -2702,6 +2703,106 @@ function createGithubAutolinksAction(options) {
   });
 }
 
+const examples = [
+  {
+    description: "Enables GitHub Pages for a repository.",
+    example: yaml__default.default.stringify({
+      steps: [
+        {
+          action: "github:pages",
+          id: "github-pages",
+          name: "Enable GitHub Pages",
+          input: {
+            repoUrl: "github.com?repo=repo&owner=owner",
+            buildType: "workflow",
+            sourceBranch: "main",
+            sourcePath: "/",
+            token: "gph_YourGitHubToken"
+          }
+        }
+      ]
+    })
+  }
+];
+
+function createGithubPagesEnableAction(options) {
+  const { integrations, githubCredentialsProvider } = options;
+  return pluginScaffolderNode.createTemplateAction({
+    id: "github:pages:enable",
+    examples,
+    description: "Enables GitHub Pages for a repository.",
+    schema: {
+      input: {
+        type: "object",
+        required: ["repoUrl"],
+        properties: {
+          repoUrl: {
+            title: "Repository Location",
+            description: `Accepts the format 'github.com?repo=reponame&owner=owner' where 'reponame' is the new repository name and 'owner' is an organization or username`,
+            type: "string"
+          },
+          buildType: {
+            title: "Build Type",
+            type: "string",
+            description: 'The GitHub Pages build type - "legacy" or "workflow". Default is "workflow'
+          },
+          sourceBranch: {
+            title: "Source Branch",
+            type: "string",
+            description: 'The the GitHub Pages source branch. Default is "main"'
+          },
+          sourcePath: {
+            title: "Source Path",
+            type: "string",
+            description: 'The the GitHub Pages source path - "/" or "/docs". Default is "/"'
+          },
+          token: {
+            title: "Authorization Token",
+            type: "string",
+            description: "The token to use for authorization to GitHub"
+          }
+        }
+      }
+    },
+    async handler(ctx) {
+      const {
+        repoUrl,
+        buildType = "workflow",
+        sourceBranch = "main",
+        sourcePath = "/",
+        token: providedToken
+      } = ctx.input;
+      const octokitOptions = await pluginScaffolderBackendModuleGithub.getOctokitOptions({
+        integrations,
+        credentialsProvider: githubCredentialsProvider,
+        token: providedToken,
+        repoUrl
+      });
+      const client = new octokit.Octokit(octokitOptions);
+      const { owner, repo } = pluginScaffolderNode.parseRepoUrl(repoUrl, integrations);
+      if (!owner) {
+        throw new errors.InputError("Invalid repository owner provided in repoUrl");
+      }
+      ctx.logger.info(
+        `Attempting to enable GitHub Pages for ${owner}/${repo} with "${buildType}" build type, on source branch "${sourceBranch}" and source path "${sourcePath}"`
+      );
+      await client.request("POST /repos/{owner}/{repo}/pages", {
+        owner,
+        repo,
+        build_type: buildType,
+        source: {
+          branch: sourceBranch,
+          path: sourcePath
+        },
+        headers: {
+          "X-GitHub-Api-Version": "2022-11-28"
+        }
+      });
+      ctx.logger.info("Completed enabling GitHub Pages");
+    }
+  });
+}
+
 const githubModule = backendPluginApi.createBackendModule({
   pluginId: "scaffolder",
   moduleId: "github",
@@ -2751,6 +2852,10 @@ const githubModule = backendPluginApi.createBackendModule({
             integrations,
             githubCredentialsProvider,
             config
+          }),
+          createGithubPagesEnableAction({
+            integrations,
+            githubCredentialsProvider
           })
         );
       }
@@ -2763,6 +2868,7 @@ exports.createGithubAutolinksAction = createGithubAutolinksAction;
 exports.createGithubDeployKeyAction = createGithubDeployKeyAction;
 exports.createGithubEnvironmentAction = createGithubEnvironmentAction;
 exports.createGithubIssuesLabelAction = createGithubIssuesLabelAction;
+exports.createGithubPagesEnableAction = createGithubPagesEnableAction;
 exports.createGithubRepoCreateAction = createGithubRepoCreateAction;
 exports.createGithubRepoPushAction = createGithubRepoPushAction;
 exports.createGithubWebhookAction = createGithubWebhookAction;