⚠️ Maintenance Notice

This repository is no longer actively maintained. Since its creation, IBM Cloud tools have evolved significantly, and I no longer use IBM Cloud in my daily work. The image may still work, but I won't be providing updates or support.

Consider using IBM Cloud Official Docker Images or the IBM Cloud CLI directly.

IBMCloud CLI Docker

Docker Pulls Docker Size GitHub Stars License Build

• ✅ Zero installation - Comes with IBMCloud CLI and all plugins pre-installed
• ✅ CI/CD ready - Set environment variables and you're ready to go
• ✅ Small footprint - Alpine-based image for minimal size
• ✅ Always up-to-date - (削除) Automatic builds with the latest version (削除ここまで) (builds paused)

📋 Table of Contents

🚀 Quick Start

Basic Usage

docker run -it \
 -e IBM_CLOUD_API_KEY=$IBM_CLOUD_API_KEY \
 -e IBM_CLOUD_REGION=us-south \
 oda2/ibmcloud-cli

With Docker Compose

services:
 ibmcloud:
 image: oda2/ibmcloud-cli
 environment:
 IBM_CLOUD_API_KEY: ${IBM_CLOUD_API_KEY}
 IBM_CLOUD_REGION: us-south
 volumes:
 - ./scripts:/scripts
 command: /bin/bash

🔧 Environment Variables

🔄 CI/CD Usage

GitHub Actions

jobs:
 deploy:
 runs-on: ubuntu-latest
 steps:
 - name: Login to IBM Cloud
 uses: oda2/docker-ibmcloud-cli@v1
 with:
 api-key: ${{ secrets.IBM_CLOUD_API_KEY }}
 region: us-south
 - name: List clusters
 run: ibmcloud ks cluster ls

GitLab CI

deploy:
 image: oda2/ibmcloud-cli
 variables:
 IBM_CLOUD_API_KEY: $IBM_CLOUD_API_KEY
 IBM_CLOUD_REGION: us-south
 script:
 - ibmcloud ks cluster ls

Jenkins

pipeline {
 agent {
 docker {
 image 'oda2/ibmcloud-cli'
 args '-e IBM_CLOUD_API_KEY=$IBM_CLOUD_API_KEY -e IBM_CLOUD_REGION=us-south'
 }
 }
 stages {
 stage('Deploy') {
 steps {
 sh 'ibmcloud ks cluster ls'
 }
 }
 }
}

Azure DevOps

- task: Docker@2
 inputs:
 command: 'run'
 imageName: 'oda2/ibmcloud-cli'
 containerCommand: 'ibmcloud ks cluster ls'
 envVars: |
 IBM_CLOUD_API_KEY=$(IBM_CLOUD_API_KEY)
 IBM_CLOUD_REGION=us-south

📦 Installed Plugins

Checking Plugins

$ ibmcloud plugin list
Listing installed plug-ins...
Plugin Name Version Status
cloud-object-storage 1.3.1 Update Available
container-registry 0.1.567 Update Available
kubernetes-service 0.3.254 Update Available
schematics 0.0.27 Update Available

💡 Advanced Examples

Running Specific Commands

docker run --rm \
 -e IBM_CLOUD_API_KEY=$IBM_CLOUD_API_KEY \
 -e IBM_CLOUD_REGION=us-south \
 oda2/ibmcloud-cli ibmcloud ks cluster ls

Using with Kubernetes

# Authenticate and get cluster credentials
docker run --rm \
 -e IBM_CLOUD_API_KEY=$IBM_CLOUD_API_KEY \
 -e IBM_CLOUD_REGION=us-south \
 oda2/ibmcloud-cli ibmcloud ks cluster config --cluster my-cluster
# Download kubeconfig
docker run --rm \
 -e IBM_CLOUD_API_KEY=$IBM_CLOUD_API_KEY \
 -e IBM_CLOUD_REGION=us-south \
 -v $(pwd):/output \
 oda2/ibmcloud-cli ibmcloud ks cluster config --cluster my-cluster --export > /output/kubeconfig

Build and Push Images

docker run --rm \
 -e IBM_CLOUD_API_KEY=$IBM_CLOUD_API_KEY \
 -e IBM_CLOUD_REGION=us-south \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v $(pwd):/app \
 oda2/ibmcloud-cli sh -c "
 ibmcloud cr build -t registry.us-south.io/myapp:latest /app
 "

🤝 Contributing

📄 License

GitHub Stars

Made with ❤️ by Renato Oda