feat: add deploy-kernel action and Dockerfile validation

CHANGELOG.md

@@ -30,6 +30,11 @@ uses: qBraid/upload-course-action@v0.1.0-beta
 - Fixed JSend response parsing in deploy and polling scripts to support `{status, data}` envelope format
 - Added guard in `action.yml` to fail early with a clear error when `course_custom_id` is empty after create/update step
 - Replaced silent `pass` with warning logs when API response parsing fails
+- Failed kernel deployment polling immediately on terminal API errors instead of retrying until timeout
+- Made the deploy-kernel wrapper reuse the shared Dockerfile validator implementation
+
+### Changed
+- Treat active pre-existing kernels as a successful deploy outcome for rerun-safe custom kernel workflows
 
 ### Added
 - Unit tests for JSend response handling in course creation and polling

deploy-kernel/action.yml

@@ -0,0 +1,87 @@
+name: 'Deploy Custom Kernel to qBraid'
+description: 'Validates and deploys a custom Jupyter kernel image to qBraid qBook'
+author: 'qBraid'
+
+branding:
+  icon: 'cpu'
+  color: 'purple'
+
+inputs:
+  api-key:
+    description: 'qBraid API key for authentication'
+    required: true
+  dockerfile-path:
+    description: 'Path to the kernel Dockerfile'
+    required: false
+    default: 'Dockerfile.kernel'
+  kernel-name:
+    description: 'Unique kernel name (lowercase alphanumeric + underscore, 3-64 chars)'
+    required: true
+  language:
+    description: 'Kernel language (python, cpp, julia, r, rust, go, javascript)'
+    required: true
+  display-name:
+    description: 'Human-readable display name for the kernel'
+    required: true
+  context-dir:
+    description: 'Directory containing additional build context files (requirements.txt, kernel.json, etc.)'
+    required: false
+    default: '.'
+  api-base-url:
+    description: 'qBraid API base URL'
+    required: false
+    default: 'https://api-v2.qbraid.com/api/v1'
+  timeout-seconds:
+    description: 'Maximum time to wait for deployment to finish'
+    required: false
+    default: '1800'
+
+outputs:
+  kernel-name:
+    description: 'The deployed kernel name'
+    value: ${{ steps.deploy-kernel.outputs.kernel-name }}
+  image-uri:
+    description: 'The Artifact Registry image URI'
+    value: ${{ steps.deploy-kernel.outputs.image-uri }}
+  status:
+    description: 'Deployment status (active, failed, timeout)'
+    value: ${{ steps.deploy-kernel.outputs.status }}
+  build-id:
+    description: 'Cloud Build ID'
+    value: ${{ steps.deploy-kernel.outputs.build-id }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+
+    - name: Install dependencies
+      shell: bash
+      run: |
+        python -m pip install -q -r "${{ github.action_path }}/requirements.txt"
+
+    - name: Validate Dockerfile
+      shell: bash
+      run: |
+        python ${{ github.action_path }}/src/scripts/validate_dockerfile.py \
+          "${{ inputs.dockerfile-path }}"
+
+    - name: Deploy kernel
+      id: deploy-kernel
+      shell: bash
+      env:
+        QBRAID_API_KEY: ${{ inputs.api-key }}
+        QBRAID_DEPLOY_TIMEOUT_SECONDS: ${{ inputs.timeout-seconds }}
+      run: |
+        echo "::add-mask::$QBRAID_API_KEY"
+        python ${{ github.action_path }}/src/scripts/deploy_kernel.py \
+          --dockerfile-path "${{ inputs.dockerfile-path }}" \
+          --kernel-name "${{ inputs.kernel-name }}" \
+          --language "${{ inputs.language }}" \
+          --display-name "${{ inputs.display-name }}" \
+          --context-dir "${{ inputs.context-dir }}" \
+          --api-base-url "${{ inputs.api-base-url }}" \
+          --timeout-seconds "${{ inputs.timeout-seconds }}"

deploy-kernel/requirements.txt

@@ -0,0 +1 @@
+requests>=2.31.0