damv1paramikossh-forscriptspipeline 0.2.0

damv1paramikossh_forscriptspipeline

A specialized, Cython-compiled Python package designed to execute remote SSH commands via Paramiko. Engineered for CI/CD pipeline scripts with enhanced source code protection (obfuscation).

Overview

This package provides a robust command-line interface to authenticate with remote servers and execute shell commands. It features automatic credential detection, seamlessly handling both password-based and private key-based authentication.

Security Enhancement (v0.2.0+): Core logic is compiled into C-extensions (.so/.pyd), preventing easy reverse-engineering or unauthorized modification of the execution logic.

Key Features

• Source Code Obfuscation: Compiled via Cython for enhanced security in shared or restricted environments.
• Automatic Credential Detection: Intelligently distinguishes between OpenSSH private keys and plain-text passwords.
• Pipeline-Ready Exit Codes: Propagates the remote command's exit status directly to the shell.
• Clean Log Output: Structured output formatting optimized for CI/CD log readability.

Platform Compatibility Warning

Due to Cython compilation, this package is architecture and OS-specific.

• A wheel built on macOS ARM64 will ONLY run on macOS ARM64.
• A wheel built on Linux x86_64 will ONLY run on Linux x86_64.
• Recommendation: Build the distribution wheel on the same OS/architecture where it will be deployed, or use a CI/CD matrix build (e.g., cibuildwheel).

Installation

Install the package directly from PyPI using pip:

pip install damv1paramikossh_forscriptspipeline

CLI Syntax

damv1paramikossh_forscriptspipeline <SERVER> <SSH_USERNAME> <SSH_PORT> <PASSWORD_OR_KEY> "<COMMAND>"

Parameters

Usage Examples

Example 1: Bitbucket Pipeline (Linux x86_64 Environment)

pipelines:
  default:
    - step:
        name: Execute Remote Command via SSH Key
        image: python:3.10-slim
        script:
          - pip install damv1paramikossh_forscriptspipeline
          - damv1paramikossh_forscriptspipeline ${SERVER} ${SSH_USERNAME} ${SSH_PORT} "${SSH_PRIVATE_KEY}" "kubectl rollout restart deployment/inbound-wms -n sit"

Example 2: Local Testing (Match your local OS/Arch)

# Ensure single quotes are used to prevent shell expansion of special characters
damv1paramikossh_forscriptspipeline '103.186.30.214' 'ubuntu' '22' 'p4$$W0Rd2025!' 'uname -a'

Maintainer

• Author: dhonyabumuhammad (Djogja)
• Contact: baba-rtw24150@tutamail.com
• Version: 0.2.0 (Cython Secured)