Salesforce ELF Browser 安装与配置指南

1. 项目基础介绍

Salesforce ELF Browser 是一个开源项目，它允许用户通过网页应用访问和下载 Salesforce 组织中的应用日志文件。这种日志文件对于安全审计、应用性能监控和功能使用分析非常有用。本项目是一个用 Ruby 编写的 Web 应用，基于 Rails 框架。

2. 项目使用的关键技术和框架

本项目主要使用了以下技术和框架：

• Ruby on Rails: 用于构建 Web 应用的框架。
• OAuth: 用于 Salesforce 登录认证。
• ActionController::Streaming: 用于流式传输文件下载。
• Heroku: 云平台，用于部署和运行应用。
• Docker: 容器化技术，用于本地开发和部署。

3. 项目安装和配置准备工作

在开始安装之前，请确保您的系统已经安装以下软件：

• Ruby（推荐版本 >= 2.7.6）
• Rails
• Git
• Docker（可选，用于本地开发）
• Salesforce 账户（用于获取 OAuth 凭据）

安装步骤

步骤 1: 克隆项目

首先，从 GitHub 克隆项目到本地：

git clone https://github.com/abisek/salesforce-elf-browser.git
cd salesforce-elf-browser

步骤 2: 设置环境变量

在项目目录中创建一个 .env 文件，并设置以下环境变量：

SALESFORCE_ELF_CONSUMER_KEY=你的Salesforce生产环境消费者密钥
SALESFORCE_ELF_CONSUMER_SECRET=你的Salesforce生产环境消费者密钥
SALESFORCE_ELF_SANDBOX_CONSUMER_KEY=你的Salesforce沙盒环境消费者密钥
SALESFORCE_ELF_SANDBOX_CONSUMER_SECRET=你的Salesforce沙盒环境消费者密钥
SECRET_KEY_BASE=生成的一个安全密钥，可以使用`rake secret`生成

步骤 3: 安装依赖

使用以下命令安装项目所需的 Ruby 依赖项：

bundle install

步骤 4: 配置数据库

根据需要配置 config/database.yml 文件。如果是使用 SQLite，默认配置即可。

步骤 5: 迁移数据库

运行以下命令来创建和迁移数据库：

rake db:create
rake db:migrate

步骤 6: 启动服务

使用以下命令启动 Rails 服务器：

rails server

现在，您应该能够在浏览器中通过 http://localhost:3000 访问应用。

步骤 7: 配置 Salesforce 连接

按照项目中 "Hosting your own instance of Salesforce Event Log File Browser" 部分的指示，在 Salesforce 中创建一个连接应用，并获取消费者密钥和密钥。

步骤 8: 部署到生产环境（可选）

如果想要将应用部署到 Heroku 或其他平台，请按照项目中提供的说明进行操作。

以上就是 Salesforce ELF Browser 的详细安装和配置指南。按照上述步骤操作后，您应该能够成功运行并使用该应用。