Skip to content

Latest commit

 

History

History
35 lines (25 loc) · 2 KB

README.deploy.md

File metadata and controls

35 lines (25 loc) · 2 KB

Deploy SONiC with ansible playbook

This doc describes the steps for deploy SONiC software on top of SONiC base image. By default, the playbook will use public sonicdev debian APT repository and public sonicdev Docker registry.

Requirements

  • Prepare a switch with the SONiC base image. See this link
  • If you are using your own APT repo or docker registry, packages and docker images must be uploaded to the repositories before running following steps.

Deploy SONiC

  • Update inventory file with correct information for your environment.

    • ansible_host = management ip address
    • sonic_hwsku = Supported Hardware SKU, e.g. Force10-S6000, ACS-MSN2700
  • Update group_vars/sonic/variables file with:

    • Replace sonicadmin_user and ansible_ssh_user with the username you built into the baseimage
    • Replace sonicadmin_initial_password with the password you built into baseimage.
    • Update [ntp,syslog,dns]_servers with a list of your server IPs for these services.
    • Update APT repository if you are using private repo.
    • Update Docker registry if you are using private registry.

    NOTE: for more information about credentials variables, see: credentials management configuration.

  • Update management IP of switch1

  • Run the playbook:

  ansible-playbook deploy_sonic.yml -i inventory --limit switch1 --become -e "bootstrap=yes"

Note: -e "bootstrap=yes" passes a special flag to update the initial admin password to the permanent password. This is not required after the first run.