Access-Boston Config

Repo: https://github.com/CityOfBoston/access-boston-config

This repository exists to manage changes to the "front end" side of the Access Boston website without the need of a developer. The changes that can be made are for: application icons, application names, application links, and application access/assigned security group. The changes will be made by editing the "config files" for each of the website environments (i.e. development, test, production). The changes need to be made on each environment separately. The following are step-by-step instructions on how to make these edits.

Once these edits are made and saved there will be an automated notification to the digital team. The digital team will initiate the site to be 're-built'. The changes should appear on the Access Boston site within 30-60 minutes.

It is encouraged to make these changes Monday-Firday, 9 a.m.-5 p.m., if possible, to ensure that if something goes run that there are available staff to help resolve.

Edit and Deploy Process

1. From the repository landing page, edit the config file for the environment (dev/test/prod) you want to change, by going from the 'src' and the 'config' folder; the click on the folder for the environment you want to edit.

   • 

2. Click on the 'apps.yaml' file, from the details view click the 'Edit this File' icon.

   Adding new links require 3 of the following fields:

   • title
   • url
   • *groups
   • *icon

   *Icon is require for links in the 'Apps' section, at the top of the file.

   *Groups is a list of groups of people with access that application. The formatting should follow this style:

   

3. When you're done making changes, go to the bottom of the page where it says 'Commit Changes' and provide a name and description for the changes made.

4. Leave the "Commit directly to the 'master' branch" radio button checked

5. When you're done, hit the "Commit Changes" button

6. No you can go back to either the homepage or commits page to view this commit's progress.

Homepage Commits page

If you see a yellow dot next to the commit, its still being processed, once its done the dot will check to a green check mark if it passed or a red x if it failed

Passed Failed

Once the build for the commit passes, our build integration with Travis notifies Digital Team will be notified via Slack that we can restart the application on AWS.