= Integrating !GitHub Version Control with Chef System Management =

== Overview ==
Identity and Access Management has access to three contexts in University of Alaska GitHub Repository:
 * Personal (identified by UA Username)
 * OIT - IAM
 * OIT - Security

Within the OIT - IAM repository, there are two types of repositories, those that represent a Chef managed system and those that contain Source files.

== Choosing a Context ==
Once logged in by default, the context will be set to a user's personal repository.  A drop down button allows the user to select the desired context for IAM activities.

[[Image(AK github context selection.png)]][[br]]

=== Identifying Chef Cookbooks versus Source Files ===
A convention has been established for identifying which repositories contain Chef cookbooks, i.e., the configuration for an entire system, or source files to run an application.  By convention, anything that is a cookbook follows the naming format of OIT-IAM/iam-<application name>-app.  

For example, the image below shows that the first three listed repositories are Chef cookbooks for the People, Shibboleth v3, and Xpress Connect (XPC) applications.  The fourth listing contains source files for the the application, people.alaksa.edu.

[[Image(AK OIT IAM repositories.png)]][[br]]

=== Contents of Chef Cookbook Repository ===
Below is an example of a Chef Cookbook repository.  Notice a few of the keywords used to indicate standard Chef directories and files such as, recipes, kitchen.yml, metadata.rb

[[Image(OIT IAM example github cookbook.png)]][[br]]

=== Contents of a Source File Repository ===
The source files for people, as opposed to the Chef Cookbook, contain no set pattern, other than what is needed for the application itself.

[[Image(OIT IAM example github app source.png)]][[br]]

== Pulling a Repository to a Local Desktop ==
Login into github.alaska.edu
Use UA Username and password to login
Check repositories for latest work 
Image of curent repositories
Click on desired repository to get address to clone it
Click on clone or download down arrow (copy or copy to clipboard) will copy the repository location.
Go to terminal window
Either create directory for location or if in a desired hierarchy type
{{{
git clone git@github.alaska.edu:serie/SelfServiceAttributes.git
}}}

Remember to pull before any edit and push often