Terraform Provider for WALLIX Bastion

A Terraform provider for managing WALLIX Bastion resources

Overview

The Terraform WALLIX Bastion provider allows you to manage WALLIX Bastion resources such as users, groups, authorizations, and more through Infrastructure as Code.

Requirements

• Visit the official Terraform website for downloads
• Go v1.22 or v1.23 (for development)

From Terraform Registry

terraform {
  required_providers {
    wallix-bastion = {
      source  = "wallix/wallix-bastion"
      version = "~> 0.14.0"
    }
  }
}

provider "wallix-bastion" {
  ip          = "your-bastion-host"
  user        = "<user>"
  token       = "<your-api-token>"
}

Local Development Installation

# Clone the repository
git clone https://github.com/wallix/terraform-provider-wallix-bastion.git
cd terraform-provider-wallix-bastion

```bash
# Build and install the provider locally
make install

Note: When testing your locally built provider, you may need to explicitly specify the local source and version in your Terraform configuration. This ensures Terraform uses your development build instead of the published version.

Example:

terraform {
  required_providers {
    wallix-bastion = {
      source  = "terraform.local/local/wallix-bastion"
      version = "0.0.0-dev"
    }
  }
}

Building the Provider

Prerequisites

Ensure you have the following installed:

• Go 1.22 to 1.24
• Make
• Git

Build Commands

# Build the provider
make build

# Build for all platforms
make build-all

# Clean build artifacts
make clean

Development Build

# Install development dependencies
go mod download

# Format code
make fmt

# Run linters
make lint

# Build development version
go build -o terraform-provider-wallix-bastion

Testing

Running Unit Tests

# Run all tests
make test

# Run tests with coverage
make test-coverage

# Run specific test
go test -v ./bastion -run TestAccResourceAuthorization_basic

Running Acceptance Tests

Acceptance tests require a running WALLIX Bastion instance.

# Set environment variables
export WALLIX_BASTION_HOST="your-bastion-host"
export WALLIX_BASTION_USER="admin"
export WALLIX_BASTION_TOKEN="<your-api-token>"
export WALLIX_BASTION_API_VERSION="v3.12"

# Run acceptance tests
make testacc

# Run specific acceptance test
TF_ACC=1 go test -v ./bastion -run TestAccResourceAuthorization_sessionSharing

Test Environment Setup

1. Set up test environment variables:

   export WALLIX_BASTION_HOST="your-test-bastion"
   export WALLIX_BASTION_TOKEN="<your-test-token>"
   export WALLIX_BASTION_USER="admin"
   export WALLIX_BASTION_API_VERSION="v3.12"
   export TF_ACC=1

2. Create test configuration:

   # Copy example configuration
   cp examples/authorization_test.tf test.tf
   
   # Edit with your test values
   vim test.tf

3. Run manual tests:

   terraform init
   terraform plan
   terraform apply
   terraform destroy

Local Development Workflow

1. Setup Development Environment

# Clone and setup
git clone https://github.com/wallix/terraform-provider-wallix-bastion.git
cd terraform-provider-wallix-bastion

# Install dependencies
go mod download
go mod tidy

# Setup pre-commit hooks (optional)
make setup-dev

2. Make Changes

# Create feature branch
git checkout -b feature/your-feature-name

# Make your changes
# ...

# Format and lint
make fmt
make lint

# Run tests
make test

3. Test Locally

# Build and install locally
make install

# Test with your Terraform configuration
cd examples/

# Choose an example directory, e.g., authorization
cd authorization

# Update the provider to use the development build

# terraform {
#   required_version = ">= 1.0"
#   required_providers {
#     wallix-bastion = {
#       # source  = "wallix/wallix-bastion"
#       # version = "0.14.7"
#       source  = "terraform.local/local/wallix-bastion"
#       version = "0.0.0-dev"
#     }
#   }
# }

terraform init
terraform plan
terraform apply

4. Submit Changes

# Run full test suite
make test-all

# Commit changes
git add .
git commit -m "feat: your feature description"
git push origin feature/your-feature-name

# Create pull request

Makefile Commands

# Build commands
make build          # Build the provider
make build-all      # Build for all platforms

# Quality commands
make fmt            # Format Go code and Terraform examples
make lint           # Run linters
make vet            # Run go vet

# Test commands
make test           # Run unit tests
make test-coverage  # Run tests with coverage
make testacc        # Run acceptance tests
make test-all       # Run all tests

# Development commands
make clean          # Clean build artifacts
make setup-dev      # Setup development environment
make install        # Install the provider locally
make docs           # Generate documentation
make docs-verify    # Verify documentation quality

# Maintenance and release commands
make maintenance    # Run maintenance tasks (deps, lint, test, build)
make dev-check      # Quick development checks (lint, test, build)
make update-deps    # Update Go dependencies only
make prepare-release # Dry-run release preparation
make release-patch  # Prepare patch release (X.Y.Z+1)
make release-minor  # Prepare minor release (X.Y+1.0)
make release-major  # Prepare major release (X+1.0.0)

See RELEASE.md for detailed release process documentation.

Documentation

• Provider Documentation
• Documentation Generation Guide - How to generate and verify documentation
• API Documentation
• Examples

Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and add tests
4. Run the test suite (make test-all)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Version Compatibility

Provider Version	Terraform Version	Go Version	WALLIX Bastion API
>= 0.14.0	>= 1.0	1.22-1.24	v3.12, v3.12
0.13.x	>= 0.14	1.19-1.21	v3.3, v3.6

License

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for details.

Special Thanks

We would like to greatly thanks:

• Claranet for their great work on this provider!
• The Terraform community for their continuous support and contributions

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions