This repository has been archived by the owner on Nov 20, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
17 additions
and
32 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,52 +1,37 @@ | ||
# govCMS Site Audit | ||
# govCMS Site Audit 7.x-2.x | ||
 | ||
|
||
This project is to help site building using the govCMS distribtion audit their site builds against acceptable use for hosting on the [govCMS SaaS platform](https://www.govcms.gov.au/how-it-works/compare-saas-and-paas). | ||
This project is to help site building using the govCMS distribtion audit their | ||
site builds against acceptable use for hosting on the | ||
[govCMS SaaS platform](https://www.govcms.gov.au/how-it-works/compare-saas-and-paas). | ||
|
||
This tool is used as a gateway for onboarding and launching sites on the platform. If you are a site builder, we recommend you use the tool prior to a onboard/forklift request to ensure your site meets the acceptable practices for hosting on the SaaS platform | ||
This tool is used as a gateway for onboarding and launching sites on the | ||
platform. If you are a site builder, we recommend you use the tool prior to a | ||
onboard/forklift request to ensure your site meets the acceptable practices | ||
for hosting on the SaaS platform | ||
|
||
|
||
## Installation | ||
|
||
To use the tool, you'll need to install it. This tool is built on [Composer](https://getcomposer.org). You'll need to first install that. Please see the [installation instuctions](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx). | ||
To audit a site locally, we recommend you download the latest auditor phar for the | ||
version of govCMS you're using from the [releases page](https://github.com/govCMS/audit-site/releases). | ||
|
||
Once you have composer installed, clone this git repository and install the dependancies with composer: | ||
|
||
``` | ||
git clone [email protected]:govCMS/audit-site.git | ||
cd audit-site | ||
composer install | ||
``` | ||
|
||
If you wish to run browser based checks (e.g. page weight check), then you will require Phantomas to be installed on your local system. Note that these checks are optional. | ||
|
||
First install Node: | ||
|
||
``` | ||
brew install node | ||
``` | ||
|
||
And then use NPM to install phantomas: | ||
|
||
wget https://github.com/govCMS/audit-site/releases/download/<LATEST_RELEASE>/audit.phar | ||
``` | ||
npm install --global --no-optional phantomas phantomjs-prebuilt@^2.1.5 | ||
``` | ||
|
||
|
||
## Usage | ||
|
||
To run the audit you'll need to have your site referenceable via a [Drush alias](https://github.com/drush-ops/drush/blob/master/examples/example.aliases.drushrc.php). The Site Audit tool relies on the connection details to the site be setup as a drush alias already. | ||
|
||
Before you conduct an audit you should always ensure your tool is up to date. | ||
|
||
``` | ||
git pull origin master | ||
composer update | ||
``` | ||
Before you conduct an audit you should always ensure you're running the latest | ||
release of the auditor. Check the [releases page](https://github.com/govCMS/audit-site/releases) for the latest version. | ||
|
||
Conducting the audit is as simple as running this one command with the correct drush alias. | ||
Conducting the audit is as simple as running this one command with the correct drush alias. If you do not have an alias setup, you can run the auditor from inside root | ||
of a Drupal site using the `@self` drush alias. | ||
|
||
``` | ||
./audit pre-forklift @site.env | ||
php audit.phar pre-forklift @self | ||
``` | ||
|
||
The audit will inform you through commandline output on the results of the audit. At the end of the audit, it will also provide an HTML report that you can open in a browser. |