fix: enable GitHub-hosted Linux bubblewrap support (#77)

## Summary
- enable unprivileged user namespaces on GitHub-hosted Linux runners
during Codex setup, regardless of the requested sandbox mode
- clear the Ubuntu AppArmor userns gate when present so bubblewrap can
bring up loopback
- document that this also covers workflows that bootstrap Codex once and
invoke `codex` in later steps

## Testing
- `yq eval '.' action.yml >/dev/null`
- `git diff --check -- action.yml README.md`

Fixes #75
This commit is contained in:
viyatb-oai
2026-03-16 23:00:12 -07:00
committed by GitHub
parent 97b5e25269
commit 88e1ee42fb
2 changed files with 27 additions and 0 deletions
+1
View File
@@ -130,6 +130,7 @@ See [Protecting your `OPENAI_API_KEY`](./docs/security.md#protecting-your-openai
- **Windows**: GitHub-hosted Windows runners lack a supported sandbox. Set `safety-strategy: unsafe`. The action validates this and exits early otherwise.
- **Linux/macOS**: All options for `safety-strategy` are supported. Again, if you pick `drop-sudo`, remember that later steps in your `job` that rely on `sudo` will fail. If you do need to run code that requires `sudo` after `openai/codex-action` has run, one option is to pipe the output of `openai/codex-action` to a fresh `job` on a new host and to continue your workflow from there.
- **GitHub-hosted Linux runners**: The action enables unprivileged user namespaces during setup and clears Ubuntu's AppArmor gate when present. This avoids the `bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted` failure seen on newer hosted images, including workflows that use the action once to bootstrap Codex and then call `codex` in later steps. Self-hosted Linux runners still need equivalent kernel support configured ahead of time.
## Outputs
+26
View File
@@ -259,6 +259,32 @@ runs:
--port "$PROXY_PORT" \
--safety-strategy "$SAFETY_STRATEGY"
- name: Enable Linux user namespaces for bubblewrap
if: ${{ runner.os == 'Linux' && runner.environment == 'github-hosted' && (inputs['openai-api-key'] != '' || inputs.prompt != '' || inputs['prompt-file'] != '') }}
shell: bash
run: |
set -euo pipefail
# Bubblewrap needs unprivileged user namespaces on GitHub-hosted Linux
# runners. This step runs before drop-sudo, then becomes a no-op on
# later codex-action invocations in the same job because the sysctls
# already have the desired values. See issue #75 for the failure mode
# this is working around on newer Ubuntu images.
current_userns="$(sysctl -n kernel.unprivileged_userns_clone 2>/dev/null || true)"
if [ -n "$current_userns" ] && [ "$current_userns" != "1" ]; then
echo "Enabling kernel.unprivileged_userns_clone for bubblewrap."
sudo sysctl -w kernel.unprivileged_userns_clone=1
fi
# Ubuntu 24.04+ can additionally block unprivileged user namespaces via
# AppArmor, which causes bubblewrap to fail with
# `loopback: Failed RTM_NEWADDR: Operation not permitted`.
current_apparmor="$(sysctl -n kernel.apparmor_restrict_unprivileged_userns 2>/dev/null || true)"
if [ -n "$current_apparmor" ] && [ "$current_apparmor" != "0" ]; then
echo "Disabling kernel.apparmor_restrict_unprivileged_userns for bubblewrap."
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
fi
- name: Drop sudo privilege, if appropriate
if: ${{ inputs['safety-strategy'] == 'drop-sudo' && inputs['openai-api-key'] != '' }}
shell: bash