使用Chef在Windows系统上安装Tomcat的问题求助

Hey there, sorry to hear you're having trouble getting Tomcat installed on your Windows Server 2016 node using Chef. Let's walk through common pitfalls and share a working recipe tailored for Windows, since many community cookbooks are Unix-focused and miss Windows-specific nuances.

• Path & Permission Issues: Most community cookbooks use Unix-style paths (like /opt/tomcat) and don't account for Windows' filesystem structure. Also, Chef Client must run with administrator privileges on Windows—otherwise it can't install packages, modify system environment variables, or register services.
• Missing Dependencies: Tomcat requires a Java Runtime Environment (JRE) to run, and Windows Server 2016 might not have it pre-installed. Many cookbooks assume Java is already present, which breaks the install flow.
• Service Registration: Windows uses a different service management system than Linux. Cookbooks built for Unix won't handle service.bat (Tomcat's Windows service installer) correctly.
• Version Compatibility: Some older cookbooks only support outdated Tomcat versions that don't play well with Windows Server 2016. Stick to Tomcat 9.x or 10.x for better compatibility.

Here's a tested recipe that handles all Windows-specific steps, from installing Java to registering Tomcat as a service:

# Install OpenJDK 11 JRE (stable, compatible with Windows Server 2016)
windows_package 'OpenJDK 11 JRE' do
  source 'INSERT_DIRECT_MSI_LINK_FOR_YOUR_PREFERRED_JRE' # e.g., from a trusted JRE provider's official releases
  installer_type :msi
  action :install
end

# Set JAVA_HOME system environment variable
# Update the value to match your JRE's installation path
windows_env 'JAVA_HOME' do
  value 'C:\Program Files\Eclipse Adoptium\jdk-11.0.20.8-hotspot'
  action :create
end

# Create temp directory if it doesn't exist
directory 'C:\temp' do
  action :create
end

# Download Tomcat 9.x (check Tomcat's archive for latest compatible version)
remote_file 'C:\temp\apache-tomcat-9.0.78-windows-x64.zip' do
  source 'INSERT_DIRECT_ZIP_LINK_FOR_YOUR_DESIRED_TOMCAT_VERSION' # from Apache Tomcat's official archive
  checksum 'INSERT_SHA256_CHECKSUM_FROM_TOMCAT_DOWNLOAD_PAGE' # Verify this against the official archive
  action :create
  not_if { ::File.exist?('C:\temp\apache-tomcat-9.0.78-windows-x64.zip') }
end

# Unzip Tomcat to standard Windows program directory
windows_zipfile 'C:\Program Files\Apache Software Foundation\Tomcat 9.0' do
  source 'C:\temp\apache-tomcat-9.0.78-windows-x64.zip'
  action :unzip
  not_if { ::File.directory?('C:\Program Files\Apache Software Foundation\Tomcat 9.0') }
end

# Set CATALINA_HOME system environment variable
windows_env 'CATALINA_HOME' do
  value 'C:\Program Files\Apache Software Foundation\Tomcat 9.0'
  action :create
end

# Register Tomcat as a Windows service using its built-in service.bat
execute 'Install Tomcat Service' do
  command "#{node['tomcat']['home']}\\bin\\service.bat install"
  cwd "#{node['tomcat']['home']}\\bin"
  action :run
  not_if { ::Win32::Service.exists?('Tomcat9') }
end

# Start Tomcat service and set it to auto-start on boot
service 'Tomcat9' do
  action [:start, :enable]
end

• Java Installation: We recommend using a well-maintained, free JRE like Adoptium's OpenJDK, which works seamlessly with Windows. Make sure the MSI link points to a trusted source.
• Checksum Validation: Always include the SHA256 checksum for downloaded files to avoid corrupt or tampered packages—you can find this value on the official Tomcat download page.
• Environment Variables: JAVA_HOME and CATALINA_HOME are required for Tomcat to run correctly on Windows. Double-check the paths match your actual installation locations.
• Service Management: Using Tomcat's native service.bat ensures the service is registered properly with Windows' Service Control Manager (SCM), making it easy to start/stop via Chef or the Windows Services console.

• Custom Configuration: If you need to modify Tomcat's config files (like server.xml or web.xml), use Chef's template resource to replace them with your custom version:

  template 'C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf\server.xml' do
    source 'server.xml.erb'
    cookbook 'your_custom_cookbook'
    action :create
  end
  

• Log Monitoring: Configure Windows Event Viewer to track Tomcat service events, or set up a log rotation policy for Tomcat's own logs in CATALINA_HOME/logs.
• Test in Staging: Always test the recipe in a staging environment first to catch any path or permission issues before deploying to production.

内容的提问来源于stack exchange，提问作者Ahtesham Ansari