Initial release

Author: ishinvin

.github/workflows/test.yml

@@ -0,0 +1,58 @@
+name: Test Action
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test-default:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Oracle Instant Client (default)
+        id: oracle
+        uses: ./
+        with:
+          version: "19.30.0.0.0"
+
+      - name: Verify installation
+        run: |
+          echo "ORACLE_HOME=${ORACLE_HOME}"
+          echo "LD_LIBRARY_PATH=${LD_LIBRARY_PATH}"
+          echo "Output oracle-home=${{ steps.oracle.outputs.oracle-home }}"
+          ls -la "${ORACLE_HOME}"
+
+  test-basic:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Oracle Instant Client (basic)
+        uses: ./
+        with:
+          version: "19.30.0.0.0"
+          variant: "basic"
+
+      - name: Verify installation
+        run: |
+          echo "ORACLE_HOME=${ORACLE_HOME}"
+          ls -la "${ORACLE_HOME}"
+
+  test-v23:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Oracle Instant Client (v23)
+        uses: ./
+        with:
+          version: "23.26.1.0.0"
+
+      - name: Verify installation
+        run: |
+          echo "ORACLE_HOME=${ORACLE_HOME}"
+          ls -la "${ORACLE_HOME}"

.gitignore

@@ -0,0 +1 @@
+.DS_Store

README.md

@@ -0,0 +1,75 @@
+# Setup Oracle Instant Client
+
+GitHub Action to download and setup [Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client.html) on Linux GitHub Actions runners.
+
+## Usage
+
+```yaml
+steps:
+  - uses: ishinvin/setup-oracle-instantclient@v1
+    with:
+      version: "19.30.0.0.0"
+```
+
+### With custom variant
+
+```yaml
+steps:
+  - uses: ishinvin/setup-oracle-instantclient@v1
+    with:
+      version: "23.26.1.0.0"
+      variant: "basic"
+```
+
+### Using outputs
+
+```yaml
+steps:
+  - uses: ishinvin/setup-oracle-instantclient@v1
+    id: oracle
+    with:
+      version: "19.30.0.0.0"
+
+  - run: echo "Installed to ${{ steps.oracle.outputs.oracle-home }}"
+```
+
+## Inputs
+
+| Input     | Description                             | Required | Default     |
+| --------- | --------------------------------------- | -------- | ----------- |
+| `version` | Oracle Instant Client version           | Yes      |             |
+| `variant` | Package variant: `basic` or `basiclite` | No       | `basiclite` |
+
+## Outputs
+
+| Output        | Description                                    |
+| ------------- | ---------------------------------------------- |
+| `oracle-home` | Path to the Oracle Instant Client installation |
+
+## Available Versions
+
+| Major | Example Versions              |
+| ----- | ----------------------------- |
+| 23.x  | `23.26.1.0.0`, `23.9.0.25.07` |
+| 21.x  | `21.20.0.0.0`, `21.10.0.0.0`  |
+| 19.x  | `19.30.0.0.0`, `19.11.0.0.0`  |
+
+> ARM64 runners are only supported for version 23 or later.
+
+## Environment Variables
+
+The action sets the following environment variables:
+
+- `ORACLE_HOME` - Oracle Instant Client installation path
+- `LD_LIBRARY_PATH` - Includes Instant Client libraries
+- Adds Instant Client directory to `PATH`
+
+## Platform
+
+Linux runners only (Ubuntu). For self-hosted runners, ensure `curl` and `unzip` are installed.
+
+## License
+
+This action is licensed under the MIT License.
+
+Oracle Instant Client is proprietary software owned by Oracle Corporation. By using this action, you agree to the [Oracle Free Use Terms and Conditions](https://www.oracle.com/downloads/licenses/oracle-free-license.html). Oracle Instant Client is downloaded directly from Oracle's official distribution site.

action.yml

@@ -0,0 +1,78 @@
+name: "Setup Oracle Instant Client"
+description: "Download and setup Oracle Instant Client on a GitHub Actions runner"
+author: "ishinvin"
+
+branding:
+  icon: "database"
+  color: "red"
+
+inputs:
+  version:
+    description: "Oracle Instant Client version (e.g. 19.30.0.0.0)"
+    required: true
+  variant:
+    description: "Package variant: basic or basiclite"
+    required: false
+    default: "basiclite"
+
+outputs:
+  oracle-home:
+    description: "Path to the Oracle Instant Client installation"
+    value: ${{ steps.setup.outputs.oracle-home }}
+
+runs:
+  using: "composite"
+  steps:
+    - name: Download and install Oracle Instant Client
+      id: setup
+      shell: bash
+      env:
+        VERSION: ${{ inputs.version }}
+        VARIANT: ${{ inputs.variant }}
+      run: |
+        set -euo pipefail
+
+        INSTALL_DIR="${RUNNER_TOOL_CACHE}/oracle-instantclient/${VERSION}"
+
+        if [[ -d "${INSTALL_DIR}/instantclient" ]]; then
+          echo "Oracle Instant Client ${VERSION} already installed"
+          ORACLE_HOME=$(readlink -f "${INSTALL_DIR}/instantclient")
+          echo "oracle-home=${ORACLE_HOME}" >> "$GITHUB_OUTPUT"
+          exit 0
+        fi
+
+        # Map architecture
+        ARCH=$([ "$(uname -m)" = "x86_64" ] && echo "x64" || echo "arm64")
+
+        # Build download path segment: 19.30.0.0.0 -> 1930000
+        PATH_SEGMENT=$(echo "${VERSION}" | tr -d '.')
+
+        BASE_URL="https://download.oracle.com/otn_software/linux/instantclient/${PATH_SEGMENT}"
+
+        # Download (try with dbru suffix first, then without)
+        echo "Downloading Oracle Instant Client ${VERSION} (${VARIANT}) for ${ARCH}..."
+        TMP_DIR=$(mktemp -d)
+        URL="${BASE_URL}/instantclient-${VARIANT}-linux.${ARCH}-${VERSION}dbru.zip"
+        if ! curl -fsSL -o "${TMP_DIR}/instantclient.zip" "${URL}" 2>/dev/null; then
+          URL="${BASE_URL}/instantclient-${VARIANT}-linux.${ARCH}-${VERSION}.zip"
+          curl -fsSL -o "${TMP_DIR}/instantclient.zip" "${URL}"
+        fi
+
+        # Install
+        sudo mkdir -p "${INSTALL_DIR}"
+        sudo unzip -qo "${TMP_DIR}/instantclient.zip" -d "${INSTALL_DIR}"
+        sudo ln -sf "${INSTALL_DIR}"/instantclient_*/ "${INSTALL_DIR}/instantclient"
+        rm -rf "${TMP_DIR}"
+
+        ORACLE_HOME=$(readlink -f "${INSTALL_DIR}/instantclient")
+        echo "Installed to: ${ORACLE_HOME}"
+        echo "oracle-home=${ORACLE_HOME}" >> "$GITHUB_OUTPUT"
+
+    - name: Configure environment
+      shell: bash
+      env:
+        ORACLE_HOME: ${{ steps.setup.outputs.oracle-home }}
+      run: |
+        echo "ORACLE_HOME=${ORACLE_HOME}" >> "$GITHUB_ENV"
+        echo "LD_LIBRARY_PATH=${ORACLE_HOME}${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}" >> "$GITHUB_ENV"
+        echo "${ORACLE_HOME}" >> "$GITHUB_PATH"