@khester/create-dynamics-app 1.0.8 → 1.1.0

package/templates/dynamics-365-starter/deployment/scripts/deploy.sh

@@ -0,0 +1,582 @@
+#!/bin/bash
+
+# Dynamics 365 Deployment Automation Script (Bash)
+# Cross-platform deployment script for Linux/macOS environments
+
+set -euo pipefail
+
+# Script configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+DEPLOYMENT_DIR="${PROJECT_ROOT}/deployment"
+LOG_DIR="${DEPLOYMENT_DIR}/logs"
+BACKUP_DIR="${DEPLOYMENT_DIR}/backups"
+
+# Default values
+ENVIRONMENT=""
+CONFIG_PATH="config/environments"
+DRY_RUN=false
+FORCE=false
+SOLUTION_PATH="solutions"
+SKIP_BACKUP=false
+VERBOSE=false
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+MAGENTA='\033[0;35m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Logging functions
+log() {
+    local level="${1:-INFO}"
+    local message="$2"
+    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
+    local log_entry="[$timestamp] [$level] $message"
+    
+    echo -e "$log_entry" | tee -a "$LOG_FILE"
+    
+    case "$level" in
+        ERROR)   echo -e "${RED}$log_entry${NC}" >&2 ;;
+        WARN)    echo -e "${YELLOW}$log_entry${NC}" ;;
+        SUCCESS) echo -e "${GREEN}$log_entry${NC}" ;;
+        INFO)    echo -e "$log_entry" ;;
+    esac
+}
+
+show_banner() {
+    echo -e "${CYAN}"
+    echo "╔══════════════════════════════════════════════════════════════╗"
+    echo "║              Dynamics 365 Deployment Automation             ║"
+    echo "║                  Enterprise Consulting Edition              ║"
+    echo "╚══════════════════════════════════════════════════════════════╝"
+    echo -e "${NC}"
+    echo
+    echo -e "${YELLOW}Environment: $ENVIRONMENT${NC}"
+    echo -e "${YELLOW}Timestamp:   $(date '+%Y-%m-%d %H:%M:%S')${NC}"
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "${MAGENTA}Mode:        DRY RUN (no changes will be made)${NC}"
+    fi
+    echo
+}
+
+show_usage() {
+    cat << EOF
+Usage: $0 [OPTIONS] <environment>
+
+Deploy Dynamics 365 application to specified environment.
+
+ARGUMENTS:
+    environment     Target environment (dev, test, staging, prod)
+
+OPTIONS:
+    -c, --config-path PATH     Configuration directory path (default: config/environments)
+    -s, --solution-path PATH   Solution files directory path (default: solutions)
+    -n, --dry-run             Perform a dry run without making changes
+    -f, --force               Force deployment even if errors occur
+    --skip-backup             Skip environment backup
+    -v, --verbose             Enable verbose output
+    -h, --help                Show this help message
+
+EXAMPLES:
+    $0 dev                    Deploy to development environment
+    $0 prod --dry-run         Dry run deployment to production
+    $0 test --force           Force deployment to test environment
+    $0 staging --skip-backup  Deploy to staging without backup
+
+EOF
+}
+
+parse_arguments() {
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            -c|--config-path)
+                CONFIG_PATH="$2"
+                shift 2
+                ;;
+            -s|--solution-path)
+                SOLUTION_PATH="$2"
+                shift 2
+                ;;
+            -n|--dry-run)
+                DRY_RUN=true
+                shift
+                ;;
+            -f|--force)
+                FORCE=true
+                shift
+                ;;
+            --skip-backup)
+                SKIP_BACKUP=true
+                shift
+                ;;
+            -v|--verbose)
+                VERBOSE=true
+                shift
+                ;;
+            -h|--help)
+                show_usage
+                exit 0
+                ;;
+            -*)
+                echo "Unknown option: $1" >&2
+                show_usage
+                exit 1
+                ;;
+            *)
+                if [ -z "$ENVIRONMENT" ]; then
+                    ENVIRONMENT="$1"
+                else
+                    echo "Unexpected argument: $1" >&2
+                    show_usage
+                    exit 1
+                fi
+                shift
+                ;;
+        esac
+    done
+
+    if [ -z "$ENVIRONMENT" ]; then
+        echo "Error: Environment argument is required" >&2
+        show_usage
+        exit 1
+    fi
+
+    case "$ENVIRONMENT" in
+        dev|test|staging|prod)
+            ;;
+        *)
+            echo "Error: Invalid environment '$ENVIRONMENT'. Must be one of: dev, test, staging, prod" >&2
+            exit 1
+            ;;
+    esac
+}
+
+setup_logging() {
+    # Create log directory
+    mkdir -p "$LOG_DIR"
+    
+    # Set log file
+    LOG_FILE="${LOG_DIR}/deploy-${ENVIRONMENT}-$(date '+%Y%m%d-%H%M%S').log"
+    
+    # Create log file
+    touch "$LOG_FILE"
+    
+    log "INFO" "Deployment log initialized: $LOG_FILE"
+}
+
+load_configuration() {
+    log "INFO" "Loading configuration for environment: $ENVIRONMENT"
+    
+    local config_file="${PROJECT_ROOT}/${CONFIG_PATH}/${ENVIRONMENT}.json"
+    
+    if [ ! -f "$config_file" ]; then
+        log "ERROR" "Configuration file not found: $config_file"
+        exit 1
+    fi
+    
+    # Validate JSON
+    if ! jq empty "$config_file" 2>/dev/null; then
+        log "ERROR" "Invalid JSON in configuration file: $config_file"
+        exit 1
+    fi
+    
+    # Export configuration as environment variables
+    eval "$(jq -r '
+        def to_env_var(prefix):
+            to_entries[] | "\(prefix)_\(.key | ascii_upcase)=\(.value | @sh)";
+        
+        to_env_var("D365")
+    ' "$config_file")"
+    
+    log "INFO" "Configuration loaded successfully"
+}
+
+check_prerequisites() {
+    log "INFO" "Checking deployment prerequisites..."
+    
+    # Check required tools
+    local required_tools=("node" "npm" "jq" "curl")
+    
+    for tool in "${required_tools[@]}"; do
+        if ! command -v "$tool" &> /dev/null; then
+            log "ERROR" "Required tool not found: $tool"
+            exit 1
+        fi
+    done
+    
+    # Check if build artifacts exist
+    local dist_path="${PROJECT_ROOT}/dist"
+    if [ ! -d "$dist_path" ]; then
+        log "ERROR" "Build artifacts not found. Please run 'npm run build:prod' first."
+        exit 1
+    fi
+    
+    # Check if solution files exist (optional)
+    local solution_dir="${PROJECT_ROOT}/${SOLUTION_PATH}"
+    if [ ! -d "$solution_dir" ]; then
+        log "WARN" "Solution directory not found, will deploy web resources only"
+    fi
+    
+    log "INFO" "Prerequisites check completed successfully"
+}
+
+build_application() {
+    log "INFO" "Building application for deployment..."
+    
+    cd "$PROJECT_ROOT"
+    
+    if [ "$DRY_RUN" = true ]; then
+        log "INFO" "DRY RUN: Would build application with 'npm run build:prod'"
+        return 0
+    fi
+    
+    # Run build
+    if npm run build:prod; then
+        log "SUCCESS" "Application built successfully"
+    else
+        log "ERROR" "Failed to build application"
+        exit 1
+    fi
+}
+
+create_backup() {
+    if [ "$SKIP_BACKUP" = true ]; then
+        log "INFO" "Skipping environment backup as requested"
+        return 0
+    fi
+    
+    log "INFO" "Creating environment backup..."
+    
+    mkdir -p "$BACKUP_DIR"
+    
+    local backup_name="backup-${ENVIRONMENT}-$(date '+%Y%m%d-%H%M%S')"
+    local backup_file="${BACKUP_DIR}/${backup_name}.tar.gz"
+    
+    if [ "$DRY_RUN" = true ]; then
+        log "INFO" "DRY RUN: Would create backup: $backup_file"
+        return 0
+    fi
+    
+    # In real implementation, you would create an actual backup
+    # For now, create a placeholder backup
+    if tar -czf "$backup_file" -C "$PROJECT_ROOT" dist/ config/ 2>/dev/null; then
+        log "SUCCESS" "Backup created successfully: $backup_file"
+    else
+        if [ "$FORCE" = true ]; then
+            log "WARN" "Backup failed but continuing due to --force flag"
+        else
+            log "ERROR" "Failed to create backup"
+            exit 1
+        fi
+    fi
+}
+
+deploy_web_resources() {
+    log "INFO" "Deploying web resources..."
+    
+    local dist_path="${PROJECT_ROOT}/dist"
+    local web_resources=()
+    
+    # Find all files in dist directory
+    while IFS= read -r -d '' file; do
+        local relative_path="${file#$dist_path/}"
+        local web_resource_name="dynamics_ui_kit_$(echo "$relative_path" | tr '/' '_' | tr '.' '_')"
+        web_resources+=("$web_resource_name|$file|$relative_path")
+    done < <(find "$dist_path" -type f -print0)
+    
+    log "INFO" "Found ${#web_resources[@]} web resources to deploy"
+    
+    for resource in "${web_resources[@]}"; do
+        IFS='|' read -r name filepath relativepath <<< "$resource"
+        
+        if [ "$DRY_RUN" = true ]; then
+            log "INFO" "DRY RUN: Would deploy web resource: $name"
+        else
+            if deploy_single_web_resource "$name" "$filepath" "$relativepath"; then
+                log "SUCCESS" "Web resource deployed successfully: $name"
+            else
+                log "ERROR" "Failed to deploy web resource: $name"
+                if [ "$FORCE" != true ]; then
+                    exit 1
+                fi
+            fi
+        fi
+    done
+    
+    # Publish customizations
+    if [ "$DRY_RUN" != true ]; then
+        log "INFO" "Publishing customizations..."
+        publish_customizations
+        log "SUCCESS" "Customizations published successfully"
+    fi
+}
+
+deploy_single_web_resource() {
+    local name="$1"
+    local filepath="$2"
+    local relativepath="$3"
+    
+    # In real implementation, you would use D365 Web API
+    # This is a placeholder for the actual deployment logic
+    
+    local api_url="${D365_DYNAMICS365_WEBAPIURL}/webresourceset"
+    local content_base64=$(base64 -w 0 "$filepath")
+    local file_type=$(get_web_resource_type "$filepath")
+    
+    local json_payload=$(jq -n \
+        --arg name "$name" \
+        --arg displayname "Dynamics UI Kit - $relativepath" \
+        --arg content "$content_base64" \
+        --arg webresourcetype "$file_type" \
+        '{
+            name: $name,
+            displayname: $displayname,
+            content: $content,
+            webresourcetype: ($webresourcetype | tonumber)
+        }')
+    
+    # Simulate API call (in real implementation, use actual D365 Web API)
+    if [ "$VERBOSE" = true ]; then
+        log "INFO" "Deploying: $name (type: $file_type)"
+    fi
+    
+    # Return success for simulation
+    return 0
+}
+
+get_web_resource_type() {
+    local filepath="$1"
+    local extension="${filepath##*.}"
+    
+    case "${extension,,}" in
+        js)   echo "3" ;;  # JavaScript
+        css)  echo "2" ;;  # CSS
+        html) echo "1" ;;  # HTML
+        htm)  echo "1" ;;  # HTML
+        xml)  echo "4" ;;  # XML
+        png)  echo "5" ;;  # PNG
+        jpg)  echo "6" ;;  # JPG
+        jpeg) echo "6" ;;  # JPG
+        gif)  echo "7" ;;  # GIF
+        ico)  echo "10";; # ICO
+        svg)  echo "11";; # SVG
+        *)    echo "8" ;;  # Other
+    esac
+}
+
+publish_customizations() {
+    # In real implementation, call D365 PublishAllXml action
+    log "INFO" "Publishing all customizations..."
+    return 0
+}
+
+deploy_solutions() {
+    local solution_dir="${PROJECT_ROOT}/${SOLUTION_PATH}"
+    
+    if [ ! -d "$solution_dir" ]; then
+        log "INFO" "No solutions directory found, skipping solution deployment"
+        return 0
+    fi
+    
+    log "INFO" "Deploying solutions..."
+    
+    # Find all solution files
+    local solution_files=()
+    while IFS= read -r -d '' file; do
+        solution_files+=("$file")
+    done < <(find "$solution_dir" -name "*.zip" -print0 | sort -z)
+    
+    if [ ${#solution_files[@]} -eq 0 ]; then
+        log "INFO" "No solution files found in $solution_dir"
+        return 0
+    fi
+    
+    for solution_file in "${solution_files[@]}"; do
+        local solution_name=$(basename "$solution_file")
+        
+        if [ "$DRY_RUN" = true ]; then
+            log "INFO" "DRY RUN: Would deploy solution: $solution_name"
+        else
+            if deploy_single_solution "$solution_file"; then
+                log "SUCCESS" "Solution deployed successfully: $solution_name"
+            else
+                log "ERROR" "Failed to deploy solution: $solution_name"
+                if [ "$FORCE" != true ]; then
+                    exit 1
+                fi
+            fi
+        fi
+    done
+}
+
+deploy_single_solution() {
+    local solution_file="$1"
+    local solution_name=$(basename "$solution_file")
+    
+    log "INFO" "Deploying solution: $solution_name"
+    
+    # In real implementation, use D365 Web API or PowerShell
+    # This is a placeholder for actual solution import
+    
+    return 0
+}
+
+run_post_deployment_tests() {
+    log "INFO" "Running post-deployment tests..."
+    
+    if [ "$DRY_RUN" = true ]; then
+        log "INFO" "DRY RUN: Would run post-deployment tests"
+        return 0
+    fi
+    
+    # Test environment connectivity
+    if test_environment_connectivity; then
+        log "SUCCESS" "Environment connectivity test passed"
+    else
+        log "ERROR" "Environment connectivity test failed"
+        return 1
+    fi
+    
+    # Test web resources accessibility
+    if test_web_resources_accessibility; then
+        log "SUCCESS" "Web resources accessibility test passed"
+    else
+        log "ERROR" "Web resources accessibility test failed"
+        return 1
+    fi
+    
+    log "SUCCESS" "All post-deployment tests passed"
+    return 0
+}
+
+test_environment_connectivity() {
+    local org_url="${D365_DYNAMICS365_ORGURL}"
+    
+    if curl -s --head "$org_url" | head -n 1 | grep -q "200 OK"; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+test_web_resources_accessibility() {
+    # Test a sample web resource
+    local test_url="${D365_DYNAMICS365_ORGURL}/WebResources/dynamics_ui_kit_index_js"
+    
+    if curl -s --head "$test_url" | head -n 1 | grep -q "200 OK"; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+send_notification() {
+    local status="$1"
+    local error_message="${2:-}"
+    
+    log "INFO" "Sending deployment notification..."
+    
+    local subject="Dynamics 365 Deployment - $ENVIRONMENT - $status"
+    local body="Deployment Details:
+- Environment: $ENVIRONMENT
+- Status: $status
+- Timestamp: $(date '+%Y-%m-%d %H:%M:%S')
+- Log File: $LOG_FILE
+
+$([ -n "$error_message" ] && echo "Error Details:" && echo "$error_message")"
+    
+    # In real implementation, send actual notifications
+    # For now, just log the notification
+    log "INFO" "Notification: $subject"
+    
+    return 0
+}
+
+cleanup() {
+    log "INFO" "Performing cleanup..."
+    
+    # Clean up temporary files, restore original state if needed
+    
+    log "INFO" "Cleanup completed"
+}
+
+# Trap for cleanup on exit
+trap cleanup EXIT
+
+# Main deployment workflow
+main() {
+    parse_arguments "$@"
+    setup_logging
+    show_banner
+    
+    log "INFO" "Starting deployment to $ENVIRONMENT environment"
+    log "INFO" "Log file: $LOG_FILE"
+    
+    # Load configuration
+    load_configuration
+    
+    # Check prerequisites
+    check_prerequisites
+    
+    # Build application
+    build_application
+    
+    # Create backup
+    create_backup
+    
+    # Deploy web resources
+    deploy_web_resources
+    
+    # Deploy solutions
+    deploy_solutions
+    
+    # Run post-deployment tests
+    if run_post_deployment_tests; then
+        log "SUCCESS" "Deployment completed successfully!"
+        send_notification "SUCCESS"
+        
+        echo
+        echo -e "${GREEN}✅ Deployment completed successfully!${NC}"
+        echo -e "${CYAN}📋 Log file: $LOG_FILE${NC}"
+        
+        if [ "$DRY_RUN" != true ]; then
+            echo -e "${CYAN}🌐 Environment URL: ${D365_DYNAMICS365_ORGURL}${NC}"
+        fi
+        
+        exit 0
+    else
+        log "ERROR" "Post-deployment tests failed"
+        send_notification "FAILED" "Post-deployment tests failed"
+        
+        echo
+        echo -e "${RED}❌ Deployment failed!${NC}"
+        echo -e "${RED}Error: Post-deployment tests failed${NC}"
+        echo -e "${CYAN}📋 Log file: $LOG_FILE${NC}"
+        
+        exit 1
+    fi
+}
+
+# Error handling
+handle_error() {
+    local error_message="$1"
+    log "ERROR" "Deployment failed: $error_message"
+    send_notification "FAILED" "$error_message"
+    
+    echo
+    echo -e "${RED}❌ Deployment failed!${NC}"
+    echo -e "${RED}Error: $error_message${NC}"
+    echo -e "${CYAN}📋 Log file: $LOG_FILE${NC}"
+    
+    exit 1
+}
+
+# Set error trap
+trap 'handle_error "Unexpected error occurred"' ERR
+
+# Run main function
+main "$@"