Switch to using /github/home for storing credentials

The GitHub Action currently puts generated credentials into $GITHUB_WORKSPACE (/github/workspace). Unfortunately this is also the working directory of the checkout, so it's too easy to accidentally bundle the generated credentials into Docker containers, binaries, or anything that uses `*` or `.` as a build context.

In the past, we tried to move the exported credentials into RUNNER_TEMP or other directories, but it always introduced incompatibility with the various community workflows (Docker, self-hosted, etc.):

- google-github-actions/setup-gcloud#148
- google-github-actions/setup-gcloud#149
- google-github-actions/setup-gcloud#405
- google-github-actions/setup-gcloud#412

While undocumented, it appears that `/github/home` is an understood path, AND that path is mounted into Docker containers. That means we can export credentials outside of the workspace and still have them available inside the Docker container without users taking manual actions. This comes at three major costs:

1. We have to write the file into two locations. This isn't ideal, but it's also not the end of the world.

2. We would be relying on an undocumented filepath which GitHub could change at any point in the future. Since this is not part of the publicly-documented API, GitHub is within their rights to change this without notice, potentially breaking everyone/everything.

3. Because of the previous point, there are no environment variables that export these paths. We have to dynamically compile them, and it's a bit messy.

Author: sethvargo

README.md

@@ -26,19 +26,6 @@ support](https://cloud.google.com/support).**
 
 ## Prerequisites
 
--   Run the `actions/checkout@v4` step _before_ this action. Omitting the
-    checkout step or putting it after `auth` will cause future steps to be
-    unable to authenticate.
-
--   To create binaries, containers, pull requests, or other releases, add the
-    following to your `.gitignore`, `.dockerignore` and similar files to prevent
-    accidentally committing credentials to your release artifact:
-
-    ```text
-    # Ignore generated credentials from google-github-actions/auth
-    gha-creds-*.json
-    ```
-
 -   This action runs using Node 20. Use a [runner
     version](https://github.com/actions/virtual-environments) that supports this
     version of Node or newer.
@@ -237,20 +224,9 @@ regardless of the authentication mechanism.
     generate a credentials file which can be used for authentication via gcloud
     and Google Cloud SDKs in other steps in the workflow. The default is true.
 
-    The credentials file is exported into `$GITHUB_WORKSPACE`, which makes it
-    available to all future steps and filesystems (including Docker-based GitHub
-    Actions). The file is automatically removed at the end of the job via a post
-    action. In order to use exported credentials, you **must** add the
-    `actions/checkout` step before calling `auth`. This is due to how GitHub
-    Actions creates `$GITHUB_WORKSPACE`:
-
-     ```yaml
-     jobs:
-      job_id:
-        steps:
-        - uses: 'actions/checkout@v4' # Must come first!
-        - uses: 'google-github-actions/auth@v2'
-     ```
+    The credentials file is exported into the GitHub home directory
+    (`/github/home` on Unix, `C:/TODO/TODO` on Windows) and a special directory
+    in the temp directory that is shared with Docker-based actions.
 
 -   `export_environment_variables`: (Optional) If true, the action will export
     common environment variables which are known to be consumed by popular

src/main.ts

@@ -25,12 +25,13 @@ import {
 import {
   errorMessage,
   exactlyOneOf,
-  isEmptyDir,
   isPinnedToHead,
-  parseMultilineCSV,
   parseBoolean,
   parseDuration,
+  parseMultilineCSV,
   pinnedToHeadWarning,
+  randomFilename,
+  toPlatformPath,
 } from '@google-github-actions/actions-utils';
 
 import {
@@ -156,31 +157,43 @@ export async function run(logger: Logger) {
         throw new Error('$GITHUB_WORKSPACE is not set');
       }
 
-      // There have been a number of issues where users have not used the
-      // "actions/checkout" step before our action. Our action relies on the
-      // creation of that directory; worse, if a user puts "actions/checkout"
-      // after our action, it will delete the exported credential. This
-      // following code does a small check to see if there are any files in the
-      // directory. It emits a warning if there are no files, since there may be
-      // legitimate use cases for authenticating without checking out the
-      // repository.
-      const githubWorkspaceIsEmpty = await isEmptyDir(githubWorkspace);
-      if (githubWorkspaceIsEmpty) {
-        logger.info(
-          `⚠️ The "create_credentials_file" option is true, but the current ` +
-            `GitHub workspace is empty. Did you forget to use ` +
-            `"actions/checkout" before this step? If you do not intend to ` +
-            `share authentication with future steps in this job, set ` +
-            `"create_credentials_file" to false.`,
-        );
+      // Generate an output file that is unique, but still coupled to the run
+      // and run attempt.
+      const outputFileSuffix = [
+        process.env.GITHUB_REPOSITORY_OWNER_ID,
+        process.env.GITHUB_REPOSITORY_ID,
+        process.env.GITHUB_RUN_ID,
+        process.env.GITHUB_RUN_ATTEMPT,
+        randomFilename(4),
+      ].join('-');
+      const outputFile = `gha-creds-${outputFileSuffix}.json`;
+
+      // TODO: figure out how to do this path on Windows
+      const hostHomeFolder = '/github/home';
+
+      console.log('\n\n');
+      console.log('\nprocess.env:\n');
+      console.log({ env: process.env });
+      console.log('\n\n');
+
+      // /home/runner/work/_temp/_github_home/gha-creds-<random>.json
+      const startingPoint = process.env.GITHUB_OUTPUT;
+      if (!startingPoint) {
+        throw new Error('$GITHUB_OUTPUT is not set');
       }
+      const homeRunnerTemp = startingPoint.slice(0, startingPoint.indexOf('_runner_file_commands'));
+      logger.debug(`Found home runner temp: "${homeRunnerTemp}"`);
 
-      // Create credentials file.
-      const outputFile = generateCredentialsFilename();
-      const outputPath = pathjoin(githubWorkspace, outputFile);
-      const credentialsPath = await client.createCredentialsFile(outputPath);
+      const dockerHomeFolder = toPlatformPath(`${homeRunnerTemp}/_github_home`);
+      logger.debug(`Computed GitHub home Docker mount: "${dockerHomeFolder}"`);
+
+      // Create credentials files.
+      const hostHomeOutputPath = pathjoin(hostHomeFolder, outputFile);
+      const credentialsPath = await client.createCredentialsFile(hostHomeOutputPath);
       logger.info(`Created credentials file at "${credentialsPath}"`);
 
+      // TODO: copy to docker path
+
       // Output to be available to future steps.
       setOutput('credentials_file_path', credentialsPath);