Apache ActiveMQ Artemis 2.34.0 User Manual

• 语言: 英语
• 格式: .pdf
• 来源: activemq.apache.org

摘要

《Apache ActiveMQ Artemis 2.34.0 User Manual》详细介绍了Apache ActiveMQ Artemis的功能和使用方法。Apache ActiveMQ Artemis是一个开源的多协议、嵌入式、高性能、高可用性的异步消息系统。文档涵盖了其核心功能，如消息代理、消息队列管理、安全性配置、协议支持（包括JMS、AMQP、MQTT等）、大消息处理、慢消费者检测、消息计数器以及容器化部署等。通过丰富的示例和详细说明，文档展示了如何配置和使用ActiveMQ Artemis来满足不同的应用场景需求。

AI总结

### Apache ActiveMQ Artemis 2.34.0 User Manual Summary

#### 1. **General Project Information**
- **Apache ActiveMQ Artemis** is an open-source, multi-protocol, high-performance, clustered, and asynchronous messaging system.
- It is an example of Message-Oriented Middleware (MoM), designed for reliable message delivery.
- **Key Features**:
- Multi-protocol support (e.g., AMQP, MQTT, HTTP, WebSocket, OpenWire).
- High performance and scalability.
- Embedded and clustered capabilities.
- Role-based security with LDAP and OAuth integration.
- Message grouping, last-value queues, and slow consumer detection.
- Integration with Spring and JMX.
- SSL/TLS support for secure communication.
- Large message handling with persistence.

#### 2. **Key Examples and Features**
- **Security**:
- Role-based access control (RBAC) with LDAP and Keycloak integration.
- OAuth2 support for web console and JMS clients.
- **Message Handling**:
- **Scheduled Messages**: Delayed delivery until a specified time.
- **Slow Consumer Detection**: Configure policies to handle slow consumers.
- **Last-Value Queues**: Retain only the latest message for a specific property (e.g., stock prices).
- **Message Groups**: Ensure messages are consumed by a single consumer.
- **Static Message Selectors**: Filter messages based on static criteria.
- **Advanced Features**:
- Asynchronous send acknowledgments for confirmation of message processing.
- Management notifications for server events (e.g., consumer creation, authentication failures).
- Message counters for queue statistics.

#### 3. **Docker Integration**
- **Quick Start**: Use official Docker images to deploy ActiveMQ Artemis quickly.
- Command to start a container:

    $ docker run --detach --name mycontainer -p 61616:61616 -p 8161:8161 --rm apache/activemq-artemis:latest-alpine

- Access the web console at `http://localhost:8161` with credentials `artemis`.
- **Custom Images**: Build custom images using the provided scripts.

#### 4. **Protocol Configuration**
- **Supported Protocols**: AMQP, MQTT, HTTP, WebSocket, OpenWire, and more.
- **Configuring Acceptors**: Enable specific protocols on acceptors using the `protocols` URL parameter.
- Example:

    
      tcp://localhost:5672?protocols=MQTT,AMQP
    

#### 5. **Server Usage**
- **Creating a Broker Instance**:
- Instances should be created outside the main distribution directory (e.g., `/var/lib/mybroker`).
- Use the `artemis` shell command for basic tasks like queue creation and message management.
- **Directory Layout**:
- `bin`: Contains scripts for running the server.
- `lib`: JAR files and libraries.
- `schema`: XML schemas for configuration validation.
- `web`: Web context for the management console.

#### 6. **Performance and Scalability**
- **High Performance**: Designed for high throughput and low latency.
- **Large Messages**: Messages are persisted on disk and can be as large as available disk space allows.

#### 7. **Upgrade Notes**
- **From 2.3.0 to 2.4.0**:
- Create `management.xml` for JMX configuration.
- Remove Jolokia WAR file from `bootstrap.xml`.
- **From 2.4.0 to 2.34.0**:
- Updated logging configuration and management features.

#### 8. **Additional Highlights**
- **Security Enhancements**: Support for masked passwords and certificate revocation lists.
- **HA and Metrics**: Configurable HA using JDBC persistence and enhanced queue metrics.
- **OpenWire Support**: Compatible with ActiveMQ Classic clients (5.12.x+).

---

### Summary
Apache ActiveMQ Artemis 2.34.0 is a versatile, high-performance messaging system with extensive protocol support, security features, and integration capabilities. Its modular design and clustering capabilities make it suitable for enterprise-grade applications. Key features include role-based security, message grouping, last-value queues, and Docker integration for quick deployment. The documentation provides detailed guidance on configuration, management, and best practices for using the system effectively.