Tez's Programming & IT

[App] FaceLapse - Daily

Tez.Park — Sun, 26 Aug 2018 20:33:32 +0900

FaceLapse - Daily

당신의 일상을 기록하고,
당신이 어떻게 변화하는지 보면서,
사람들과 공유하세요!

--------------------

매일 거울을 보면 어제와 같은 내 모습이 보인다.
하지만! 왜 사람들은 내 모습이 변했다고 그럴까?
다른 사람들은 내 변화를 알지만, 나는 알지 못한다.

이제 매일 당신의 모습을 기록하고, 변하고 있는 당신의 모습을 만나보세요. 그리고 더 멋진 모습으로 변해보세요!
FaceLapse와 함께.

--------------------

FaceLapse는 당신이 매일 찍어놓은 사진을 가지고 몇번의 클릭만으로 멋진 슬라이드쇼를 만들어 줍니다.
생성된 슬라이드쇼는 공유하기 기능을 통해 카메라롤에 저장할 수 있고, 연인 그리고 가족들에게 공유할 수 있습니다.

https://itunes.apple.com/app/id1407902384

[App] Basket - Shopping

Tez.Park — Tue, 21 Aug 2018 23:56:44 +0900

Basket - Shopping

'가장 간단한 쇼핑 리스트.'

불필요한 기능들은 모두 빼고 기본에 충실한 장보기 앱입니다.

'Basket'은 가장 간편한 장보기 노트가 되어줄 것입니다.
장볼때 사야하는 것들을 간단하게 메모하고,
가족이나 친구에게 공유하여 함께 장을 볼 수 있습니다.
또한, 내가 어떤것들을 구매 했는지 간편하게 관리할 수 있습니다.

지금 바로 사용해보세요!

https://itunes.apple.com/app/id1427525566

[따라하기] 웹이미지 가져와서 동적으로 테이블뷰 그리기 (UITableView + WebImage + dynamicCellHeight)

Tez.Park — Fri, 8 Jun 2018 10:44:36 +0900

이 글은 요청에 의해 작성되는 글입니다.

Summary

사이즈가 다른 Web Image를 가져와서 UITableView에 그릴때, UITableViewCell의 높이를 잡아야 하는 경우들이 있다.

일반적으로 텍스트들이나 가지고 있는 이미지를 사용하여 그려줄때는 미리 사이즈를 계산해서 작업을 하면되지만, Web Image는 각 이미지마다 크기나 네트워크 상황에 따라서 받아오는 속도가 다르기 때문에 미리 UITableViewCell의 높이를 고려해 줄 수 없다.

이런 경우에 사용하는 방법을 간단하게 알아보자

(웹이미지를 사용한 동적인 셀 그리지 예제이므로 이미지의 캐싱처리같은 고도화 관련 내용은 제외함)

0. 기본기

Self-Sizing Table View Cells

UITableViewAutomaticDimension, estimatedRowHeight

iOS 에서 이전에는 UITableView 자체에 rowHeight를 지정해주거나, UITableView delegate의 tableView:heightForRowAtIndexPath: 통해서 높이를 지정해 주었다.

iOS8 부터 UITableView에서 UITableViewCell의 높이를 동적으로 지정해줄 수 있는 Self-Sizing 방식이 추가되었다.

Self-Sizing 방식을 사용하려면 tableView의 rowHeight 의 속성을 UITableViewAutomaticDimension 로 설정하고, estimatedRowHeight 속성에도 값을 할당해 주어야 한다. (아래 코드를 참고하자)

tableView.estimatedRowHeight = 85.0

tableView.rowHeight = UITableViewAutomaticDimension

1. 프로젝트 생성 및 테이블뷰 추가

본격적으로 프로젝트를 생성하고 코드를 구현하면서 예제를 진행해보자.

우선 Swift 프로젝트 하나를 생성하고, storyboard 에 tableView 를 추가한 후 constraints 값을 지정하고 ViewController에 기본 tableView 설정을 해주도록 하자.

storyboard에 tableView 추가

그냥 TableView를 view 위에 얹어주면 된다.

TableView의 Constraints 설정

view를 모두 채우기 위해 margin을 모두 0으로주자.

TableView의 outlets을 ViewController에 연결

tableView를 선택하고 오른쪽버튼을 누른채로 ViewController로 끌어주면 Outlets 연결 화면이 뜬다.

여기서 dataSource와 delegate를 연결해주자

ViewController에 tableView 객체 추가

Xcode 우측위에 Assistant editor (oo 두개가 겹쳐진 버튼)을 눌러 ViewController를 열어주고 storyboar의 객체를 오른쪽버튼을 누른채로 끌어넣어주면 바로 코드에 추가할 수 있다.

TableView 사용을 위한 기본 코드 추가

storyboard 연결은 모두 끝이 낫으니 tableView를 사용할때 필요한 필수 코드들을 추가하고, 실행을 한번 해보자.

tableView를 사용하기위해 UITableViewDataSource protocol을 추가하고, 필수 함수인 numberOfRowsInSection과 cellForRow를 추가해 주어야 한다.

(이 예제에서 UITableViewDelegate의 heightForRow는 사용하지 않는다. rowHeight를 자동으로 처리할 거니까)

아래 코드를 보자.

import UIKit

class ViewController: UIViewController, UITableViewDataSource {

@IBOutlet weak var tableView: UITableView!

override func viewDidLoad() {

super.viewDidLoad()

}

override func didReceiveMemoryWarning() {

super.didReceiveMemoryWarning()

}

// MARK: - UITableViewDataSource

public func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {

return 10

}

public func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {

let cell = UITableViewCell()

cell.textLabel?.text = "\(indexPath.row)"

return cell

}

이렇게 코드를 작성하고 run을 해보면 아래처럼 tableView가 보여지게 된다.

tableView가 그려졌으니 50%는 끝이 났다! (사실 글을 쓰기위해 사진찍는 작업이 거의 다 끝났다!)

2. TableView self-sizing 적용, CustomCell class 생성, storyboard 연결

웹의 이미지를 가져와 보여줄 cell의 기본 틀을 잡아보자.

(이 예제에서는 label과 imageView를 cell에 얹어서 작업할 것이다.)

기본 UITableViewCell 위에 UILabel, UIImageView를 추가할 수도 있지만, 더 편하게 관리하고 작업하기 위해 CustomCell 을 구성해서 사용하자.

CustomCell Class 추가

필요한 내용으로만 직접 구성해서 사용할 CustomCell Class를 추가해보자.

(우선은 Class만 생성하고 label, imageView는 storyboard에서 추가하자.)

class ViewController: ~~ {

...

}

// 편의상 ViewController 아래에 CustomCell class 추가

class SelfSizingTableCell: UITableViewCell {

override init(style: UITableViewCellStyle, reuseIdentifier: String?) {

super.init(style: style, reuseIdentifier: reuseIdentifier)

}

required init?(coder aDecoder: NSCoder) {

super.init(coder: aDecoder)

}

코드로 구현할 경우 tableView에 custom cell을 등록하는 register 함수를 사용해야 하는데, 이 예제에서는 storyboard에서 직접 설정을 할 것이기 때문에 cell register 코드는 추가하지 않아도 된다.

TableView Self-Sizing적용

사이즈를 알 수 없는 Web Image를 받아와서 그려줘야 하기 때문에 tableView에다 위에 기본기 부분에서 봤던 self-sizing 설정을 추가해주자

import UIKit

private let cellId = "SelfSizingCellId"

class ViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {

@IBOutlet weak var tableView: UITableView!

override func viewDidLoad() {

super.viewDidLoad()

self.tableView.rowHeight = UITableViewAutomaticDimension

self.tableView.estimatedRowHeight = 20

}

...

Storyboard 에서 Cell 구성 - 기본

storyboard에서 cell을 구성하기 위해 우선 TableView에 cell을 하나 추가해주자.

TableView아래에 cell을 끌어서 넣어주면 아래 화면과 같이 Prototype Cells 화면이 구성된다.

추가한 Cell을 선택 후 Identity inspector를 열어서 조금전 추가한 class를 연결해주자.

생성한 CustomCell class의 이름을 넣어주면 된다.

그리고 tableView에서 reusableCell 사용시 연결될 수 있게 cell의 Attributes inspector를 열어서 Identifier를 설정해주자.

(option) Cell 설정 마지막으로 그냥 작업할때 보기 편하게 하기위해 Size inspector 에서 rowHeight를 조금 조절해주자

이건 그냥 진짜 storyboard 그릴때 편하기 위해서 사용하는 용도이다.

Storyboard 에서 Cell 구성 - label/image 추가

이제 내용을 출력해줄 label과 image를 추가하고 코드로 연결해주자

label이 위에있고, imageView가 아래에 있는 형태로 구성할 예정이다.

label 하나를 cell의 contentView 아래에 추가해주고 constraints 값을 설정해주자. label의 constraints 값은 아래에 imageView를 붙일것이기 때문에 bottom 마진은 설정하지 않는다.

imageView도 label과 같은 방법으로 추가해주는데, 깔끔하게 작업하기 위해 대충 원하는 크기로 이미지뷰 크기를 조절해두고 constraints의 모든 마진을 0으로 주면 top은 label의 bottom과 연결되고 나머지는 cell에 맞춰 마진이 설정된다.

이렇게 imageView의 크기를 조절해서 자리를 잡아주자

그리고 constraints 에서 마진 설정을 해주면!

Xcode는 똑똑하기 때문에 알아서 원하는대로 아래처럼 마진을 잡아준다.

label

imageView

결과는 이렇게 된다.

Cell 구성요소 코드에 연결

이제 다시 Assistant editor를 열어서 한쪽은 storyboard 한쪽은 코드 구현부를 열어주자.

그리고 방금전 추가한 label과 imageView를 SelfSizingTableCell class 에 tableView 객체를 생성해준것처럼 생성해주자.

편의상 label은 titleLabel로, imageView는 webImage로 네이밍하도록 하자.

연결이 되면 코드상에 아래처럼 구성이 된다.

class SelfSizingTableCell: UITableViewCell {

@IBOutlet weak var titleLabel: UILabel!

@IBOutlet weak var webImage: UIImageView!

...

Cell 사용부 수정 (cellForRow)

이제 생성한 SelfSizingTableCell을 사용할 수 있도록 tableView에서 cell을 가져오는 부분을 수정해주자.

reusableCell 로 구성하였기 때문에 기존에 cell 사용과 달리 dequeueReusableCell을 사용하여 가져오도록 수정해주고 cell의 class를 명시해주면 된다.

...

public func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {

let cell: SelfSizingTableCell = tableView.dequeueReusableCell(withIdentifier: cellId, for: indexPath) as! SelfSizingTableCell

cell.titleLabel.text = "\(indexPath.row)"

return cell

}

...

3. Web image를 받아와 Self-Sizing cell에 그려주기

저장된 이미지를 사용하는 경우는 그냥 위의 예제까지만 하고 cell에 image를 설정해주면 끝이난다.

하지만 이 예제는 웹 이미지를 다운받고 셀의 높이를 변경해주는게 궁극적인 목표이기 때문에 우선 web image를 받아오는 예제를 살펴보자.

(UIImageView에서는 기본적으로 웹이미지를 받아와서 image를 설정해주는 함수가 존재하지 않는다.

alamofire나 sdwebimage 같은 유명한 open source를 사용하면 쉽게 우리가 만드려는 기능을 사용할 수 있지만, 어떤식으로 처리되는지 이해하기 쉽도록 open source를 사용하지 않고 만들어보자.)

UIImageView web image를 위한 extension 추가

UIImageView에서는 기본적으로 웹이미지를 받아와서 image를 설정해주는 함수가 존재하지 않는다.

alamofire나 sdwebimage 같은 유명한 open source를 사용하면 쉽게 지금 만들려는 기능을 구현 수 있지만, 어떤식으로 처리되는지 기본기를 익혀볼 겸 open source를 사용하지 않고 image data를 받아와서 처리하도록 만들어보자. (간단한 진행을 위해 캐싱은 구현하지 않음)

그리고, image를 web에서 받아오기까지 시간이 걸릴 수 있기 때문에 보통 indicator를 보여주거나 placeholder 이미지를 넣어두고 다운로드가 완료되면 받아온 image 로 교체하여 사용한다. 이 예제에서는 placeholder를 이용하도록 하겠다.

위에 구현중이던 ViewController에 아래와 같이 extension 기능을 구현해주자.

...

extension UIImageView {

public func imageFromURL(urlString: String, placeholder: UIImage?, completion: @escaping () -> ()) {

if self.image == nil {

self.image = placeholder

}

URLSession.shared.dataTask(with: NSURL(string: urlString)! as URL, completionHandler: { (data, response, error) -> Void in

if error != nil {

print(error)

return

}

DispatchQueue.main.async(execute: { () -> Void in

let image = UIImage(data: data!)

self.image = image

self.setNeedsLayout()

completion()

})

}).resume()

}

이 코드는 UIImageView에 extension을 사용하여 기능을 확장해준 것이다.

코드를 보면 web에 있는 image를 받아오기 전까지 image가 nil 값인 경우 지정해준 placeholder 이미지로 imageView를 채워준 후

URLSession을 사용해서 image url에 있는 data를 받아와서 imageView의 image를 변경해주고, 후행 클로저를 사용해 completion을 호출해 주도록 되어 있다.

completion을 사용하는 이유는 tableView에서 이미지 변경 후 셀을 갱신해줄 수 있도록 하려고 해두려고 한 것이다.

후행 클로저라는 용어가 생소할 수도 있는데, 그냥 동작이 완료된 후 처리할 묶음을간단히 말하면 호출한 곳에서 처리가 완료된 후에 작업을 할 수 있도록 통로를 만들어 둔다고 생각하면 된다.

이미지 중복 갱신 방지

image를 처음 받아와 그려줄때 갱신이 안되는 이슈가 발생할 수 있기 때문에 1회에 한해서 reloadRows 라는 함수를 사용할 예정인데, cell이 그려질때마다 이 함수가 호출되면 부하가 심해지고 스크롤이 버벅이는 현상이 생길수가 있다.

이것을 막기위해 갱신을 했는지 상태값을 저장해두고 사용하도록 SelfSizingTableCell 코드에 finishReload 라는 Bool 타입의 변수를 하나 추가해주자.

이 값은 초기값으로 false값을 가지고, 그리기가 완료 true 값으로 변경해 불필요한 갱신을 막는 용도로 사용할 것이다.

class SelfSizingTableCell: UITableViewCell {

@IBOutlet weak var titleLabel: UILabel!

@IBOutlet weak var webImage: UIImageView!

var finishReload: Bool = false

...

}

cell에 web image 세팅하기

이제 마지막 단계이다.

위에서 extension으로 구현해둔 imageFromURL함수를 이용해 cell에 webImage를 web에서 받아와서 세팅해보자.

...

public func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {

...

cell.webImage.tag = indexPath.row

let urlStr: String = "https://placehold.it/200x200&text=SampleImg\(indexPath.row)"

let placeholder: UIImage? = UIImage.init(named: "placeholder.png")

cell.webImage.imageFromURL(urlString: urlStr, placeholder: placeholder) {

if cell.finishReload == false {

cell.finishReload = true

tableView.beginUpdates()

tableView.reloadRows(at: [IndexPath.init(row: cell.webImage.tag, section: 0)], with: UITableViewRowAnimation.automatic)

tableView.endUpdates()

}

return cell

}

...

이 코드를 보면 cellForRow~ 함수 내부에서 cell의 webImage를 세팅할때 imageFromURL 함수를 호출해서 이미지를 받아온다.

이미지를 받아온 후 finishReload 값을 비교해서 cell 갱신이 완료되지 않았으면 reloadRows 함수를 이용해 cell을 한번 갱신해주고, 다시 호출되지 않도록 finishReload 값을 true로 설정해 준다.

reloadRows는 tableView 전체를 갱신하는 reloadData와 달리 선택한 row들만 갱신해주는 역할을 한다.

저장되어있는 이미지나 캐싱된 이미지를 사용할 경우 reloadRows 동작은 필요하진 않다. 언제 받아올지 모르는 웹 이미지를 받아온 후 알아서 갱신을 해주면 좋겠지만, 이미 tableView를 그려주는 life cycle이 끝났기 때문에 화면을 가만히 놔둔 상태에서 이미지는 바뀌어도 크기가 바뀌지 않는 경우들이 많다.

finishReload와 reloadRows는 이런경우 바로 갱신을 해주기 위해 사용하는 트릭으로 생각하면 좋을것 같다. View life cycle을

(urlStr 값은 파라미터로 문자를 넣어주면 이미지로 만들어주는 url 주소이다. placeholder.png 파일은 없으면 그냥 nil값을 사용해도 무관하다.)

4. 실행/확인

이제 모든 구현이 완료되었고, 구동을 해보자!

처음엔 placeholder 이미지가 -> 그리고는 다운로드된 이미지가 -> 그리고 셀을 다시 그려 높이를 맞춰준다.

Fin.

간단하게 autolayout으로 요소들을 구성하고, 웹 이미지를 받아와서 동적으로 받아온 이미지 크기로 셀 높이를 맞춰서 그려주는 예제를 해보았다.

별거 아닌거 같지만 까다로운 요소들이 많이 숨어있는 작업이다.

또한, 같은 기능을 만드는 방법에 정석이 따로 있는것은 아니다. 여기서는 트릭을 이용해서 처리를 했지만 다른 더 좋은 방법들이 존재할 수 있다.

하지만 뭐니뭐니해도 가장 좋은건 이미 잘 알려진 open source를 사용하면 아주 간단하고 안정성이 보장되도록 만들수가 있다.

따라하기를 기반으로 대충 이런식으로 처리가 되는구나 정도를 생각하면서 개념을 익힌 다음에는 직접 고도화시켜서 구현을 해서 open source를 만들거나 open source를 사용하자!!

참고

Working with Self-Sizing Table View Cells

https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/AutolayoutPG/WorkingwithSelf-SizingTableViewCells.html#//apple_ref/doc/uid/TP40010853-CH25-SW1

translatesAutoresizingMaskIntoConstraints

http://blog.jisoo.net/2018/03/02/UIView-translatesAutoresizingMaskIntoConstraints.html

[Documentation] Appledoc 문서화 (Objective-c 문서화)

Tez.Park — Tue, 8 May 2018 13:03:08 +0900

Summary

개발을 하다보면 소스코드를 문서화 해야하는 경우들이 종종 발생한다.

내부적으로 볼 경우에는 주석을 잘달아서 소스코드를 직접 보면서 확인하면 되지만, 내부적으로 문서화 요청을 받거나 Wiki등록 혹은 외부에 공개해야하는 등의 경우에는 따로 문서를 만들어서 전달해야 한다. 이런 상황에서 각각의 클래스와 함수, 변수들을 정리하면서 문서로 만들면 아주 작은 프로젝트가 아닌이상 엄청난 노가다 작업을 필요로한다.

하지만 세상은 많이 발전했고, 이런 작업을 대신해주는 소스코드 문서화 도구가 다양하게 존재한다. (사실 한참 전부터 존재했다.)

예를들어 C/C++은 doxygen, python은 Sphinx, Java는 Javadoc등, 그리고 이외에도 엄청 다양한 도구들이 존재한다.

하지만, 이 글에서는 Apple 소스코드의 문서화에 특화된 문서화 도구를 찾아보려고 한다. 그중에서도 Objective-c. (Swift는 추후에..)

Objective-C 기반이기 때문에 doxygen같은 C언어 관련 문서화 도구를 사용해도 되지만, 조금 더 욕심을 내서 애플 스타일 소스코드 문서화 형태로 만들어주는 도구를 사용해보도록 하자.

최근엔 다른 종류도 많이 나왔지만, 써본건 Appledoc, Headerdoc 두가지이다. 근데 Headerdoc은 애플 폐기 문서함에 들어가 있어서 왠지 쓰기 싫다.

그래서 Appledoc 으로 문서화 방법을 쓰려고 한다.

Appledoc은 기본 탬플릿을 제공하고, 커스터마이징된 탬플릿들도 찾아보면 몇가지 존재하고.. 일단 직접 문서를 보면서 직접 사용해보도록 하자.

Appledoc 설치

AppleDoc은 오픈소스로 공개되어있고, 스크립트를 실행하여 설치하거나 Homebrew를 사용하여 설치할 수 있다.

(스크립트를 이용하면 기본 탬플릿을 설치할 수 있고, Homebrew는 기본 탬플릿을 설치할 수 없다.)

#############

# Git clone #

#############

$ git clone git://github.com/tomaz/appledoc.git

#############################

# install appledoc - Script #

########## Case 1 ###########

# 스크립트를 이용한 기본 설치

$ sudo sh install-appledoc.sh

# 1-1. 탬플릿을 기본경로에 추가해서 설치할 경우 '-t default’ 옵션을 붙여주자

$ sudo sh install-appledoc.sh -t default

# 1-2. 다른 경로를 원할 경우 '-t {template_path}’ 옵션을 붙여주자. (binary 경로는 '-b {binary_path}')

$ sudo sh install-appledoc.sh -b /usr/bin -t ~/Library/Application\ Support/appledoc

###############################

# install appledoc - Homebrew #

########## Case 1 #############

# Homebrew를 이용한 설치 (Homebrew 는 탬플릿이 기본으로 설치되지 않는다)

$ brew install appledoc

설치가 완료되면, 'appledoc' 명령어를 입력해서 제대로 설치가 되었는지 확인해보자.

$ appledoc

appledoc version: 2.2.1 (build 1334)

Caught: AppledocException: At least one directory or file name path is required, use 'appledoc --help'

Appledoc 설치가 완료되면 바로 문서를 생성할 수 있다.

하지만, 바로 사용하려면 command에 여러가지 옵션들을 넣어서 실행을 해야 하기 때문에 프로젝트 내부에 문서화 옵션들을 미리 정의해놓고 사용하는 방법들을 알아보자.

미리 정의하지 않고 사용하면 아래처럼 사용해야 한다.

$ appledoc --project-name '프로젝트명' --project-company '회사명' --template {탬플릿 경로} --create-html --output '결과물 경로' .

# 위의 명령어는 기본적인 설정들만 정의한 상태이고, 옵션들이 추가될수록 명령어가 어마어마하게 늘어난다.

프로젝트 내부 문서화 옵션 정의

문서화 옵션을 프로젝트내에 정의하는 방법은 plist 파일 추가, run script 추가 두가지 방법이 있다.

plist 파일을 생성하면 문서화 관련 옵션들을 plist로 쉽게 관리할 수 있는 장점이 있고,

run script를 사용하면 터미널을 열지 않고 문서화 타겟을 생성하여 빌드하면서 바로 문서를 생성할 수 있는 장점이 있다.

우선 두가지 모두 생성/사용 방법을 알아보자.

0. 공통

설정 가능한 전체 옵션이 궁금하다면 터미널에서 아래 명령어로 확인 가능하다.

$ appledoc --help

Usage: appledoc [OPTIONS] <paths to source dirs or files>

PATHS

-o, --output <path> Output path

-t, --templates <path> Template files path

--docset-install-path <path> DocSet installation path

-s, --include <path> Include static doc(s) at path

-i, --ignore <path> Ignore given path

-x, --exclude-output <path> Exclude given path from output

--index-desc <path> File including main index description

PROJECT INFO

-p, --project-name <string> Project name

-v, --project-version <string> Project version

-c, --project-company <string> Project company

--company-id <string> Company UTI (i.e. reverse DNS name)

OUTPUT GENERATION

-h, --create-html [b] Create HTML

-m, --create-markdown [b] Create markdown

-d, --create-docset [b] Create documentation set

-n, --install-docset [b] Install documentation set to Xcode

-u, --publish-docset [b] Prepare DocSet for publishing

--html-anchors <string> [*] The html anchor format to use in DocSet HTML.

--clean-output [b] Remove contents of output path before starting !!CAUTION!!

OPTIONS

--keep-intermediate-files [b] Keep intermediate files in output path

--keep-undocumented-objects [b] Keep undocumented objects

--keep-undocumented-members [b] Keep undocumented members

--search-undocumented-doc [b] Search undocumented members documentati

...

1. plist 사용

appledoc 오픈소스를 받으면 폴더내에 AppledocSettings.plist 라는 파일이 존재한다.

직접 생성해도 전혀 문제는 없지만, 귀찮으니 있는 파일을 이용하도록 하자.

파일은 문서화를 하려는 프로젝트 root에 위치시키면 된다. (참고로 파일명은 AppledocSettings.plist 에서 바꿀 경우 설정을 변경해줘야 하므로 변경없이 쓰도록 하자)

plist파일은 터미널에서 명령어를 직접 입력할때 사용된다. (= 문서화를 터미널 명령어로 실행해야 한다)

아래 는 plist의 내부 모습이다. 각각 옵션값들이 어떤 역할을 하는지는 주석을 확인하자.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<dict>

<key>--output</key>

<key>--templates</key>

<string>~./appledoc-jazzy</string>

<key>--include</key>

<array>

<string>Libs/Internal</string>

</array>

<key>--ignore</key>

<array>

<string>Libs/External</string>

<string>*.framework</string>

</array>

<key>--create-html</key>

<true/>

<key>--create-markdown</key>

<true/>

<key>--create-docset</key>

<true/>

<key>--install-docset</key>

<true/>

<key>--clean-output</key>

<true/>

<key>--project-name</key>

<string>AppleDoc Example</string>

<key>--project-version</key>

<key>--project-company</key>

<key>--company-id</key>

<string>kr.tez.appledoc.exam</string>

<key>--keep-intermediate-files</key>

<true/>

<key>--print-information-block-titles</key>

<true/>

<key>--preprocess-headerdoc</key>

<true/>

<key>--repeat-first-par</key>

<true/>

<key>--merge-categories</key>

<true/>

<key>--merge-category-comment</key>

<true/>

<key>--keep-merged-sections</key>

<true/>

<key>--prefix-merged-sections</key>

<true/>

<key>--explicit-crossref</key>

<true/>

<key>--use-code-order</key>

<true/>

<key>--docs-section-title</key>

<string>Tez Programming Guides </string>

<key>--exit-threshold</key>

<key>--logformat</key>

<key>--verbose</key>

</dict>

</plist>

2. RunScript

run script를 사용하려면 프로젝트 타겟에 script를 추가해주어야 한다.

기존 타겟에 추가를 할 경우 다른 스크립트들과 충돌날 수도 있기 때문에 새로운 타겟을 하나 생성해서 추가하는게 정신건강에 이로울 수 있다.

정신건강을 위해 먼저 타겟 추가 방법을 알아보자.

프로젝트 설정 -> 타겟 쭉 아래쪽에 ‘+’버튼 -> Cross-platform -> Aggregate 선택 -> 네이밍은 마음대로 하고 Finish를 해주면 새로운 타겟이 생성된다.

이제 스크립트 추가 방법을 알아보자.

프로젝트 설정 -> 생성한 타겟 선택 -> Build Phases 에 ‘+’ 버튼을 눌러서 New Run Script Phases로 스크립트를 넣을 수 있도록 추가해주자

생성된 스크립트 입력 공간에 아래 정보를 자신의 프로젝트 설정에 맞춰서 넣어주도록 하자.

#Appledoc Script

/usr/local/bin/appledoc \

--clean-output \

--output "./help" \

--templates "~/.appledoc" \

--ignore "*.framework" \

--create-html \

--no-create-docset \

--no-install-docset \

--project-name "${PROJECT_NAME}" \

--project-version "${PROJECT_VERSION}" \

--project-company "Tez Lab." \

--company-id "kr.tez.appledoc" \

--docset-platform-family "iphoneos" \

--keep-intermediate-files \

--keep-undocumented-objects \

--keep-undocumented-members \

--search-undocumented-doc \

--print-information-block-titles \

--preprocess-headerdoc \

--repeat-first-par \

--merge-categories \

--merge-category-comment \

--keep-merged-sections \

--prefix-merged-sections \

--explicit-crossref \

--use-code-order \

--docs-section-title "${PROJECT_NAME} Programming Guides " \

--exit-threshold 2 \

--no-warn-missing-output-path \

--no-warn-missing-company-id \

--warn-undocumented-object \

--warn-undocumented-member \

--warn-empty-description \

--warn-unknown-directive \

--warn-invalid-crossref \

--warn-missing-arg \

--warn-unsupported-typedef-enum \

--logformat xcode \

--verbose "2" \

문서 생성

plist를 사용한 경우와 script를 추가한 경우 모두 알아보자

1. plist 사용

위에서 언급한 것처럼 plist를 사용하면 터미널에서 명령어로 실행해 주어야 한다. (옵션을 모두 추가해 두었기 때문에 생각보다 복잡하지는 않다.)

$ appledoc .

이렇게 명령어를 입력하면 주르르륵 로그들이 나오고 문서가 생성된다.

2. Script 사용

script 를 추가해둔 경우 target을 생성해 두었기 때문에 xcode 내에서 문서화를 위해 생성한 타겟 생성 후 build를 해주면 지정해둔 경로에 문서가 생성된다.

Tip. 특정 폴더 추가/제거

1. 특정 폴더 제거

문서화를 하면서 특정 폴더를 제거하고 싶다면 ignore 옵션을 넣어주면 된다 (run script 기준)

(GenerateDoc 타겟의 Build Phases -> 작성해둔 Run script에서 제외할 경로들을 아래처럼 --ignore로 추가)

#Appledoc Script

...

--ignore "<path>" \

...

2. 특정 폴더 추가

문서화를 하면서 일부 폴더만 선택해서 문서화를 하고 싶다면, 마지막에 문서화 경로를 추가해주면 된다. (Run script 기준)

--include 옵션은 제대로 처리를 할 수 없어서 다른 방법으로 알아보자.

제거하기와 마찬가지로 Run script를 수정하는데, 일부 폴더 추가는 모든 폴더를 제외시키고 포함시킬 폴더를 전부 넣어주자. 아래 참조

#Appledoc Script

...

--ignore "." \

...

. \

<path1> \

<path2>

Custom Templates

appledoc은 내부 탬플릿을 제공하기는 하지만, 사용자가 맞춤형으로 탬플릿을 수정하여 사용할 수 있다.

여기서는 간단히 오픈소스로 공유되고 있는 두가지 탬플릿만 알아보도록 하자.

1. jazzy

jazzy 탬플릿은 조금 더 애플 문서에 맞춤형으로 생성이 되어있는 탬플릿이다. 기본 제공되는 것보다 구성이 더 깔끔하게 정리되있는 정도라고 생각하면 된다.

https://github.com/kaiinui/appledoc-template-jazzy

2. tez-custom

이건 그냥 기본 탬플릿에 objective-c code syntax 적용한 버전이다. 함수나 변수들을 볼때 조금 더 직관적으로 보기 위해서 github에 추가해 두었다.

기존 문서에서 코드 부분에 조금 더 색을 입히고 싶을때 사용하면 된다.

https://github.com/tezpark/appledoc-custom-template

ps. 코드내에 문서화 주석이 없으면 이 모든 작업이 아무 소용없다.

[NSArray] 배열에 있는 모든 객체에서 같은 함수 호출하기

Tez.Park — Mon, 7 May 2018 17:46:09 +0900

Summary

개발을 하다보면 여러 객체들을 배열형태로 관리하면서 모든 객체에 어떤 함수를 호출시키는 작업이 필요한 경우가 있다.

예를 들면 UIView 의 subViews를 호출하여 for문을 돌면서 모두 removeFromSuperview를 하는게 있다.

이런 경우 makeObjectsPerformSelector를 이용하면 쉽게 해결할 수 있다.

Example

UIView - removeFromSuperview

// Default

for (UIView *view in [self.view subviews]) {

[view removeFromSuperview];

}

// using makeObjectsPerformSelector

[[self.view subviews] makeObjectsPerformSelector:@selector(removeFromSuperview)];

ps. 이 예제 외에 다른 배열형태로 관리되는 객체들은 모두 적용이 가능해서 편리하게 사용할 수 있다.

[Fastlane] - 프로젝트 내부 배포 자동화

Tez.Park — Fri, 12 May 2017 19:02:37 +0900

Info

iOS, Android 프로젝트에서 배포를 위해 아카이브 파일 (.ipa), 패키지파일 (.apk) 을 추출하고 업로드 및 공유하는데 귀찮은 작업들이 상당히 많다.

(iOS는 scheme 바꾸고, 아카이빙하고 파일 추출하고 업로드하고 공유하고.., 안드로이드도 뭐 작업중에는 뭘 할 수가 없으니까 )

그래서 이런 귀찮은 작업을 좀 편하게 할 수 있는 방법을 찾다가 Fastlane 이라는 것을 찾다.

Fastlane 은 인증서 자동갱신, 스냅샷 추출, 아카이빙, crashlytics 배포, slack 공유, s3업로드, 테스트 플라이트, 앱스토어 등록 등등 다양한 동작을 하도록 구성할 수 있다.

자세한 내용은 아래 fastlane 사이트를 참고하는걸로 하고..

일단은 내부 배포를 위하여 프로젝트 내에서 provisioning 파일을 생성/갱신, 테스트용 뱃지 추가, 아카이브 후 추출, aws-s3에 파일 업로드, Crashlytics 에 배포 파일 업로드, slack에 결과 공유 까지만 작업을 하는 방법을 소개하려고 한다.

1. Fastlane 설치

기능을 사용하기 위해서 mac에 fastlane을 설치 해야한다. 설치 방법은 세가지가 있으니 자신의 mac 에서 주로 사용하는 방법을 선택하여 설치를 진행하면 된다.

(Homebrew 로 설치하면 fastlane 내부 ruby가 동작해서 작업이 귀찮아짐. ruby 모듈들을 fastlane 안에 ruby에 설치해줘야함. 맘편하게 Script로 설치하세요)

Homebrew

$ brew cask install fastlane

Installer Script

아래 링크에서 zip 파일을 다운로드 받고, install 스크립트를 실행

https://download.fastlane.tools/fastlane.zip

Rubygems

$ sudo gem install fastlane -NV

2. Fastlane 초기화

Fastfile, Appfile, .env 파일을 직접 생성해서 작업을 해도 되지만 귀찮으니까 iOS혹은 Android 프로젝트 루트에서 아래 명령어로 관련 파일들을 생성해주자

# fastlane 초기화

$ fastlane init

초기화 작업이 완료되면 ./fastlane 폴더 내부에 Fastfile, Appfile, .env 파일이 생성되어 기본적인 준비가 된다.

3. Plugin 설치 (aws_s3, badge) - optional

Badge

앱을 내부배포할 때 dev, stage등 여러가지 앱 스킴을 사용하는 경우들이 있는데 이럴경우 어떤 버전이 설치되어 있는지 직관적으로 알 수 있는 방법이 없다.

그래서 badge 라는 plugin을 사용하여 앱 아이콘에 뱃지를 넣어주어 직관적인 버전 확인이 가능하도록 해줄 수 있다.

아래를 참고하여 플러그인을 설치하고, 관련된 모듈들을 설치하도록 하자.

더 자세한 내용은 아래 사이트를 참고하자

https://github.com/HazAT/badge

# badge 플러그인 설치

$ fastlane add_plugin badge

# 관련 모듈 설치

$ brew install imagemagick

$ brew install librsvh

aws_s3

내부 배포를 위한 파일 서버가 S3로 설정되어 있는 경우 아카이브 파일 (.ipa), 패키지파일 (.apk) 을 생성한 후 Amazon S3 Bucket 으로 바로 전송을 할 수가 있다.

이 기능을 사용하려면 아래를 참고하여 S3 플러그인을 설치하면 되고, 조금 더 자세한 정보 및 사용법은 아래 링크에서 확인하면 된다.

https://github.com/joshdholtz/fastlane-plugin-s3

# aws-s3 플러그인 설치

$ fastlane add_plugin aws_s3

4. Fastlane 파일 설정

이제 fastlane 초기 세팅 작업들은 마무리가 되었고, 실제로 동작시킬 내용들을 추가하는 방법을 알아보도록 하자.

Fastfile

우선 가장 핵심이 되는 Fastfile 에 대해서 살펴보자.

이 파일은 platform과 lane 을 설정하고 lane 별로 어떤 동작을 시킬지, lane 실행전/후에 어떤 동작을 수행할 지 설정하는 곳이다.

아래 예제 파일을 보면서 동작들을 확인해보자.

# More documentation about how to customize your build

# can be found here:

# https://docs.fastlane.tools

fastlane_version "2.18.3"

# This value helps us track success metrics for Fastfiles

# we automatically generate. Feel free to remove this line

# once you get things running smoothly!

generated_fastfile_id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # fastfile 생성시 설정됨

default_platform :ios

#######

# iOS #

#######

platform :ios do

before_all do

# lane 실행전 수행할 동작을 설정해줄 수 있다

end

##################################################

# First iOS App Lanes - 계정 정보 A를 사용하는 앱

##################################################

lane :firstapp_debug do

# provisioning profile 생성, 갱신, 다운로드

sigh

# (Optional) badge 설정

# badge(dark: true) # 이렇게 쓸 수도 있고

badge(shield: "Version-dev-red", no_badge: true) # 이렇게 shield를 사용해서 할 수도 있다

# iOS app을 build, archive, export 한다

gym(

# 키가 workspace 인것을 확인하자

workspace: "[Project path].xcworkspace", # [Project path]: 프로젝트 xcworkspace 경로 (xcodeproj 는 secondapp 참고)

configuration: "Debug", # configuration 설정값

scheme: "[Project scheme]", # [Project scheme]: 프로젝트 scheme

silent: true,

clean: true,

output_name: "[file name]", # [file name]: 파일 추출시 파일명

include_symbols: false, # (optional)개인 설정에 맞게

include_bitcode: true, # (optional)개인 설정에 맞게 - default:false

export_method: "development", # export 작업시 method 지정

)

# (Optional) S3에 파일을 업로드 한다

aws_s3(

access_key: ENV['S3_ACCESS_KEY'], # .env 파일에 세팅

secret_access_key: ENV['S3_SECRET_ACCESS_KEY'], # .env 파일에 세팅

bucket: ENV['S3_BUCKET'], # .env 파일에 세팅

region: ENV['S3_REGION'], # .env 파일에 세팅

path: '[bucket path]', # [bucket path]: 버킷의 경로 설정

ipa: '[file name].ipa', # export되는 파일명으로 설정

upload_metadata: true,

)

# (Optional) Crashlytics에 업로드

crashlytics(

api_token: ENV['CRASHLYTICS_API_TOKEN'], # .env 파일에 세팅

build_secret: ENV['CRASHLYTICS_SECRET'] # .env 파일에 세팅

)

end

lane :firstapp_stage do

sigh

badge(shield: "Version-stage-blue", no_badge: true)

gym(

workspace: "[Project path]",

configuration: "Stage",

scheme: "[Project scheme]",

silent: true,

clean: true,

output_name: "[file name]",

include_symbols: false,

include_bitcode: true,

export_method: "ad-hoc",

)

aws_s3(

access_key: ENV['S3_ACCESS_KEY'],

secret_access_key: ENV['S3_SECRET_ACCESS_KEY'],

bucket: ENV['S3_BUCKET'],

region: ENV['S3_REGION'],

path: '[bucket path]',

ipa: '[file name].ipa',

upload_metadata: true,

)

crashlytics(

api_token: ENV['CRASHLYTICS_API_TOKEN'],

build_secret: ENV['CRASHLYTICS_SECRET']

)

end

###########################################################

# Second iOS App Lane - 계정 정보 B를 사용하는 다른 iOS 앱

###########################################################

lane :secondapp_debug do

sigh

badge(shield: "Version-dev-red", no_badge: true)

gym(

# 키가 project 인것을 확인하자

project: "[Project path].xcodeproj", # [Project path]: 프로젝트 xcodeproj 경로

configuration: "Debug",

scheme: "[Project scheme]",

silent: true,

clean: true,

output_name: "[file name]",

include_symbols: false,

include_bitcode: true,

export_method: "development",

)

aws_s3(

access_key: ENV['S3_ACCESS_KEY'],

secret_access_key: ENV['S3_SECRET_ACCESS_KEY'],

bucket: ENV['S3_BUCKET'],

region: ENV['S3_REGION'],

path: '[bucket path]',

ipa: '[file name].ipa',

upload_metadata: true,

)

crashlytics(

api_token: ENV['CRASHLYTICS_API_TOKEN'],

build_secret: ENV['CRASHLYTICS_SECRET']

)

end

# lane 수행이 성공적으로 완료된 후 수행할 동작 설정

after_all do |lane|

# slack으로 메시지를 전송한다.

slack(

message: "FastLane success",

slack_url: ENV['SLACK_URL']

)

end

# lane 수행이 실패하였을 경우 수행할 동작 설정

error do |lane, exception|

slack(

message: exception.message,

success: false,

slack_url: ENV['SLACK_URL']

)

end

##############################################################################################

###########

# Android #

###########

platform :android do

before_all do

end

##################################################

# First iOS App Lanes - 계정 정보 A를 사용하는 앱

##################################################

lane :firstapp_debug do

gradle(task: 'clean', project_dir: "[Project path]") # [Project path]: 프로젝트 root 경로

gradle(task: "assemble",

build_type: "Debug",

project_dir: "[Project path]") # [Project path]: 프로젝트 root 경로

# (Optional) 필요에 따라 shell script 를 넣을 수 있다

# shell script는 Fastfile이 있는 폴더에서 수행되기 때문에 폴더 경로가 fastlane/ 폴더로 인식된다

sh "mv ../firstapp_android/app/build/outputs/apk/firstapp-debug.apk ../firstapp_android/app/build/outputs/apk/[File name].apk" # [File name]: 파일명

# (Optional) S3에 파일을 업로드 한다

# plugin 에서 사용되는 폴더 경로는 fastlane을 실행한 위치로 인식된다

aws_s3(

access_key: ENV['S3_ACCESS_KEY'], # .env 파일에 세팅

secret_access_key: ENV['S3_SECRET_ACCESS_KEY'], # .env 파일에 세팅

bucket: ENV['S3_BUCKET'], # .env 파일에 세팅

region: ENV['S3_REGION'], # .env 파일에 세팅

path: '[bucket path]', # [bucket path]: 버킷의 경로 설정

ipa: './firstapp_android/app/build/outputs/apk/[File name].apk', # export되는 파일의 총 경로를 설정

upload_metadata: true,

)

end

lane :firstapp_stage do

gradle(task: 'clean', project_dir: "[Project path]")

gradle(

task: "assemble",

build_type: "Release",

# signing 정보를 넣어줄 수 있다

properties: {

# 'versionCode' => [version code], # (Optional) [version code]: 버전코드

# 'versionName' => [version name], # (Optional) [version name]: 버전명

'android.injected.signing.store.file'=> ENV['ANDROID_APP_SIGNING_KEY'], # .env 파일에 세팅

'android.injected.signing.store.password'=> ENV['ANDROID_APP_SIGNING_PASSWORD'], # .env 파일에 세팅

'android.injected.signing.key.alias'=> ENV['ANDROID_APP_SIGNING_ALIAS'], # .env 파일에 세팅

'android.injected.signing.key.password'=> ENV['ANDROID_APP_SIGNING_PASSWORD'] # .env 파일에 세팅

project_dir: "[Project path]")

sh "mv ../firstapp_android/app/build/outputs/apk/firstapp-release.apk ../firstapp_android/app/build/outputs/apk/[File name].apk"

aws_s3(

access_key: ENV['S3_ACCESS_KEY'],

secret_access_key: ENV['S3_SECRET_ACCESS_KEY'],

bucket: ENV['S3_BUCKET'],

region: ENV['S3_REGION'],

path: '[bucket path]',

ipa: './firstapp_android/app/build/outputs/apk/[File name].apk',

upload_metadata: true,

)

end

after_all do |lane|

slack(

message: "FastLane success",

slack_url: ENV['SLACK_URL']

)

end

error do |lane, exception|

slack(

message: exception.message,

success: false,

slack_url: ENV['SLACK_URL']

)

end

.env

다음은 환경변수를 선언해 놓고 사용하는 dotenv 형태의 .env 파일이다.

이 파일에 선언된 값들을 Fastfile 에서 ENV[‘ ‘] 형태로 사용할 수 있다.

아래는 예제용으로 작성된 Fastfile의 .env 파일이다.

# for Slack

SLACK_URL="https://hooks.slack.com/services/~~~" # slack 에서 생성한 hook 주소

# for S3

S3_ACCESS_KEY='XXXXXXX' # S3의 Access key

S3_SECRET_ACCESS_KEY='xxxxxxxxxxxxxxxx' # S3의 Sceret Access key

S3_BUCKET='example-buket' # S3의 Bucket name

S3_REGION='ap-northeast-2' # S3의 Region

# for Crashlytics

CRASHLYTICS_API_TOKEN='xxxxxxxxxxxxxxxx' # Crashlytics 에서 생성한 API token

CRASHLYTICS_SECRET='xxxxxxxxxxxxxxxx' # Crashlytics 에서 생성한 Secret 값

# for Android

ANDROID_APP_SIGNING_KEY='./keystore/firstapp_key.keystore' # Signing key

ANDROID_APP_SIGNING_PASSWORD='xxxx' # signing pw

ANDROID_APP_SIGNING_ALIAS='firstapp_android' # signing alias

Appfile

마지막으로 앱 관련 설정을 가지고 있는 Appfile 이다.

이 파을은 AppStore Id, Bundle Id, Team Id 등 식별자 값이 설정되어있는 파일이다.

Appfile 과 관련해서 더 자세한 내용은 링크를 참고하면 된다. (https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Appfile.md)

아래 파일도 예제용으로 작성된 Fastfile의 Appfile 이다.

# Default

app_identifier "kr.tez.firstapp" # The bundle identifier of your app

apple_id "dev@tez.kr" # Your Apple email address

team_id "XXXXXXX" # Developer Portal Team ID

for_platform :ios do

for_lane :first_debug do

app_identifier "kr.tez.firstapp"

apple_id "dev@tez.kr"

team_id "XXXXXXX"

end

for_lane :first_stage do

app_identifier "kr.tez.firstapp"

apple_id "dev@tez.kr"

team_id "XXXXXXX"

end

for_lane :second_debug do

app_identifier "kr.tez.secondapp"

apple_id "tez_enterprise@tez.kr"

team_id "XYXYXYXY"

end

# you can even provide different app identifiers, Apple IDs and team names per lane:

# More information: https://github.com/fastlane/fastlane/blob/master/fastlane/docs/Appfile.md

5. Fastlane 기본 명령어

lane 과 파일 작성이 완료되면 몇가지 기본적인 명령어를 확인하고 사용해보도록 하자.

`$ fastlane lanes`

우선 사용가능한 lane들을 조회하는 명령어 이다.

이 명령어로 추가해 놓은 lane들이 정상적으로 로드되는지 확인하면 된다.

$ fastlane lanes

+------------------------+---------+--------+

| Used plugins |

+------------------------+---------+--------+

| Plugin | Version | Action |

+------------------------+---------+--------+

| fastlane-plugin-aws_s3 | 0.2.4 | aws_s3 |

+------------------------+---------+--------+

[18:47:48]: -------------------------------------------------

[18:47:48]: --- Step: Verifying required fastlane version ---

[18:47:48]: -------------------------------------------------

[18:47:48]: Your fastlane version 2.28.7 matches the minimum requirement of 2.18.3 ✅

[18:47:48]: ------------------------------

[18:47:48]: --- Step: default_platform ---

[18:47:48]: ------------------------------

--------- ios---------

----- fastlane ios firstapp_debug

----- fastlane ios firstapp_stage

----- fastlane ios secondapp_debug

--------- android---------

----- fastlane android firstapp_debug

----- fastlane android firstapp_stage

Execute using `fastlane [lane_name]`

`$ fastlane env`

이 명령어는 fastlane 환경 체크를 하는 명령이다.

fasatlane이 정상적으로 실행되지 않거나 정보를 확인할 경우 이용하면 된다.

$ fastlane env

...

#너무 길어서 생략

...

6. Fastlane 실행

이제 기나긴 작업이 끝나고 완성된 lane들을 사용하는 방법이다!

작업은 길지만 실제 사용은 별거 없다.

platform과 lane 을 선택해주면 설정해준 작업들이 수행된다.

fastlane {platform} {lane}

$ fastlane ios firstapp_debug

...

# working...

...

[13:48:03]: ▸ Archive Succeeded

...

[13:48:06]: Successfully exported and compressed dSYM file

[13:48:06]: Successfully exported and signed the ipa file:

...

[13:48:06]: -------------------

[13:48:06]: --- Step: slack ---

[13:48:06]: -------------------

[13:48:07]: Successfully sent Slack notification

+------+-------------------------------------+-------------+

| fastlane summary |

+------+-------------------------------------+-------------+

| Step | Action | Time (in s) |

+------+-------------------------------------+-------------+

| 1 | Verifying required fastlane version | 0 |

| 2 | default_platform | 0 |

| 3 | gym | 23 |

| 4 | slack | 1 |

+------+-------------------------------------+-------------+

...

[13:48:07]: fastlane.tools finished successfully

위와 같이 진행과정이 표시되고 모든 작업이 완료되면 fastlane.tools finished successfully 이라는 메시지와 함께 작업이 완료된다.

끝

[Rsyslog + Loganalyzer + MySQL] 설치/구성

Tez.Park — Thu, 11 May 2017 15:51:27 +0900

Rsyslog : ver 8

LogAnalyzer : ver 4.1.3

[Server] - Rsyslog

Rsyslog 설치

wget 패키지 설치 (없는경우만)

# If not exist wget

$ yum install -y wget

$ yum update

Rsyslog 설치

# Install Rsyslog

$ wget http://rpms.adiscon.com/v8-stable/rsyslog.repo

$ mv rsyslog.repo /etc/yum.repos.d/rsyslog.repo

$ yum install -y rsyslog

$ systemctl enable rsyslog

Rsyslog-mysql 설치

# Install rsyslog-mysql

$ yum install -y rsyslog rsyslog-mysql

Mysql 설치 및 rsyslog-DB 세팅

MySQL 설치

# Install MySQL

$ wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm

$ sudo rpm -ivh mysql-community-release-el7-5.noarch.rpm

$ yum update

$ yum install -y mysql-server

$ systemctl start mysqld

MySQL 초기 설정

# Setting MySQL

$ mysql_secure_installation

Rsyslog Database 덤프

# Import rsyslog-mysql dump

$ mysql -u root -p < /usr/share/doc/rsyslog-mysql-x.x.x/createDB.sql/

Rsyslog용 계정 생성

# Create the user to access the database

$ mysql -u root -p

mysql> GRANT ALL ON Syslog.* TO 'rsyslog'@'localhost' IDENTIFIED BY 'Password'; #<- 실제 쓰는걸로 넣자

mysql> FLUSH PRIVILEGES;

mysql> exit

Rsyslog 세팅

설정파일 편집기로 실행

$ vi /etc/rsyslog.conf

설정파일에 MySQL 모듈/템플릿 추가

# Load the MySQL Module

$template SQLWithProcessID,"insert into SystemEvents (Message, Facility, FromHost, Priority, DeviceReportedTime, ReceivedAt, InfoUnitID, SysLogTag, ProcessID) values ('%msg%', %syslogfacility%, '%HOSTNAME%', %syslogpriority%, '%timereported:::date-mysql%', '%timegenerated:::date-mysql%', %iut%, '%syslogtag:R,ERE,1,FIELD:([a-zA-Z\/]+)(\[[0-9]{1,5}\])*:--end%', '%syslogtag:R,ERE,1,BLANK:\[([0-9]{1,5})\]--end%')",sql

module(load="ommysql")

action(type="ommysql"

server="localhost"

serverport="3306"

db="Syslog"

uid="rsyslog"

pwd="password" #<- 실제 쓰는걸로 넣자

template="SQLWithProcessID")

설정파일에서 UDP 통신을 위한 포트 설정 주석 제거

# Provides UDP syslog reception

# for parameters see http://www.rsyslog.com/doc/imudp.html

module(load="imudp") # needs to be done just once

input(type="imudp" port="514")

설정파일에 룰 수정

local1 은 httpd

local2 는 nginx

local3 는 python

local4 는 php

로 정의해서 쓰기로 함.

message파일 에 저장하지 않으려면 local1.!* 처럼 추가로 등록한 속성에 대해서 예외처리 걸어줘야함

#### RULES ####

...

*.emerg :omusrmsg:*

...

# Custom - tez

$template tmplmsg, "/var/log/remote/%hostname%/%programname%.log"

$template tmplhttpd, "/var/log/remote/%hostname%/httpd.log"

$template tmplhttpdaccess, "/var/log/remote/%hostname%/httpd-access.log"

$template tmplhttpderror, "/var/log/remote/%hostname%/httpd-error.log"

$template tmplnginx, "/var/log/remote/%hostname%/nginx/nginx.log"

$template tmplnginxaccess, "/var/log/remote/%hostname%/nginx/nginx-access.log"

$template tmplnginxerror, "/var/log/remote/%hostname%/nginx/nginx-error.log"

$template tmplpython, "/var/log/remote/%hostname%/%programname%.log"

$template tmplphp, "/var/log/remote/%hostname%/%programname%.log"

$template tmplauth, "/var/log/remote/%hostname%/secure/%programname%.log"

$template tmplmail, "/var/log/remote/%hostname%/maillog/%programname%.log"

$template tmplcron, "/var/log/remote/%hostname%/cron/%programname%.log"

$template tmplspooler, "/var/log/remote/%hostname%/spooler/%programname%.log"

$template tmplboot, "/var/log/remote/%hostname%/boot/%programname%.log"

*.info;local1.!*;local2.!*;local3.!*;local4.!*;mail.none;authpriv.none;cron.none ?tmplmsg #httpd.info(access)도 포함

authpriv.* ?tmplauth

mail.* ?tmplmail

cron.* ?tmplcron

uucp,news.crit ?tmplspooler

local7.* ?tmplboot

local1.*;local1.!=info;local1.!=error ?tmplhttpd

local1.info ?tmplhttpdaccess

local1.error ?tmplhttpderror

local2.*;local2.!=info;local2.!=error ?tmplnginx

local2.info ?tmplnginxaccess

local2.error ?tmplnginxerror

local3.* ?tmplpython

local4.* ?tmplphp

rsyslog 재시작

$ systemctl restart rsyslog

!! 만약 firewall / iptables / selinux 사용하는 경우 udp514 포트를 열어주자

Logrotate 설정

/etc/logroate.conf

/etc/logrotate.d/*

/etc/logrotate.d/rsyslog_remote 생성해서 템플릿으로 경로를 바꾼 로그들도 관리되게 해주자

# >$ /etc/logrotate.conf

...

#weekly

daily

...

#rotate 4

rotate 5

...

copytruncate

...

# >$ /etc/logrotate.d/rsyslog_remote

#/var/log/remote/*.log

/var/log/remote/*/*.log

/var/log/remote/*/*/*.log

{

mail dev@tez.kr # optional

daily

rotate 5

dateext

missingok

ifempty

copytruncate

create 0600 root root

sharedscripts

postrotate

/bin/kill -HUP `cat /var/run/syslogd.pid 2> /dev/null` 2> /dev/null || true

endscript

}

메일 전송을 위한 패키지 설치/설정

$ yum install mailx ncompress

# >$ vi /etc/postfix/main.cf

...

message_size_limit = 20480000

$ systemctl restart postfix

[Server] - LogAnalyzer

아파치 설치, 실행 (설치 안된 경우만)

# Install and Start Httpd (Apache2)

$ yum install -y httpd

$ systemctl start httpd

$ systemctl enable httpd

아파치 실행 후 브라우저로 확인 ( http://server-ip/ )

PHP 설치, 실행

# Install php

$yum install -y php php-mysql php-gd

# Create phpinfo page

$ nano /var/www/html/test.php

<?php

phpinfo();

# Restart Apache Service

$ systemctl restart httpd

http://server-ip/test.php 로 접속하여 php정보 확인

LogAnalyzer 설치

다운로드

$ wget http://download.adiscon.com/loganalyzer/loganalyzer-4.1.3.tar.gz

압축해제

$ tar zxvf loganalyzer-4.1.3.tar.gz

Apache에 LogAnalyrzer 설치파일 복사

cp -r loganalyzer-4.1.3/src/ /var/www/html/loganalyzer

cp -r loganalyzer-4.1.3/contrib/* /var/www/html/loganalyzer/

권한 수정

하위버전에서는 configure, secure 파일만 수정하면 되지만 권한 문제가 발생하는 경우가 종종있어서 폴더 전체에 권한 설정을 해준다.

$ cd /var/www/html/loganalyzer/

$ chmod +x configure.sh secure.sh

# If permission error occurred

$ chown apache:apache -R /var/www/html/loganalyzer/

$ find . -type f -exec chmod 0644 {} \;

$ find . -type d -exec chmod 0755 {} \;

$ chcon -t httpd_sys_content_t /var/www/html/loganalyzer -R

$ chcon -t httpd_sys_rw_content_t /var/www/html/loganalyzer -R

configure.sh 실행 -> 빈 config.php 파일을 쓰기권한으로 생성해준다

$ ./configure.sh

# If permission error occurred

$ cd /var/www/html/loganalyzer

$ touch config.php

$ chown apache:apache config.php

$ chmod 777 config.php

설치

http://server-ip/loganalyzer 접속
Step 1

Step 2

next
permission 문제 발생시 위에있는 권한관련 처리

Step 3

Enable User Database -> Yes
DB 관련 정보 입력

DatabaseName : Syslog

Require user to be logged in -> YES

Step 4

Step 5

Step 6

계정 생성
next

Step 7

Source Type -> MySQL native
Select View -> Syslog Fields
DB 정보 입력

Database Name -> Syslog
Table Name -> SystemEvents (대소문자 구분!!)

Step 8

[Client]

Rsyslog 설치

wget 패키지 설치 (없는경우만)

# If not exist wget

$ yum install -y wget

$ yum update

Rsyslog 설치

# Install rsyslog-mysql

$ yum install -y rsyslog rsyslog-mysql

Rsyslog 세팅

설정파일 편집기로 실행

$ vi /etc/rsyslog.conf

설정파일에 rsyslog server 정보 추가

apache log 전송을 위해 local1 룰 추가
모든 로그를 로그서버로 전송

local1 은 httpd

local2 는 nginx

local3 는 python

local4 는 php

로 정의해서 쓰기로 함.

message파일 에 저장하지 않으려면 local1.!* 처럼 추가로 등록한 속성에 대해서 예외처리 걸어줘야함

#### RULES ####

...

#*.info;mail.none;authpriv.none;cron.none /var/log/messages

*.info;local1.!*;local2.!*;local3.!*;local4.!*;mail.none;authpriv.none;cron.none /var/log/messages

...

# for Custom log

local1.*;local1.!=info;local1.!=error /var/log/httpd

local1.info /var/log/httpd-access

local1.error /var/log/httpd-error

local2.* /var/log/nginx

local3.* /var/log/python

local4.* /var/log/php

...

#*.* @@remote-host:514

*.* @x.x.x.x:514 # <- log server ip

rsyslog 재시작

$ systemctl restart rsyslog

Apache 세팅

apache log 를 syslog로 전달하기 위한 작업

httpd.conf 수정

ErrorLog랑 CustomLog 추가

# >$ vi /usr/local/apache2/conf/httpd.conf

...

SetEnvIfNoCase Request_URI "\.(jpg|jpeg|png|gif|bmp|css|ico|js|swf)$" exceptlist

...

#ErrorLog "logs/error_log"

ErrorLogFormat "%t %a [%v] \"%{User-Agent}i\" [%-l] %7F: %E: %M"

ErrorLog "|/usr/bin/logger -p local1.error -t httpd"

...

#CustomLog "logs/access_log" common

LogFormat "%h %l %u %t \"%v%U\" \"%r\" %>s %b \"%{User-Agent}i\" **%Tsec/%Dmsec**" combinedTez

CustomLog "|/usr/bin/logger -p local1.info -t httpd" combinedTez env=!exceptlist

httpd-vhost.conf 수정

위의 설정을 하고 이곳에 로그를 주석처리해야 rsyslog에서 설정한 로그로 저장된다.

...

...

#ErrorLog "logs/tez.kr-error_log"

#CustomLog "logs/tez.kr-access_log" common

...

</VirtualHost>

Nginx 세팅

nginx log 를 syslog로 전달하기 위한 작업 (nginx >= 1.7.1)

nginx.conf 수정

error_log, access_log 추가

# >$ vi /etc/nginx/nginx.conf

...

#error_log /var/log/nginx/error.log;

error_log syslog:server=unix:/dev/log,facility=local2,tag=nginx,severity=error;

...

http {

...

log_format main '$remote_addr - $remote_user [$time_local] "$request" '

'$status $body_bytes_sent "$http_referer" '

'"$http_user_agent" "$http_x_forwarded_for"';

#access_log /var/log/nginx/access.log main;

access_log syslog:server=unix:/dev/log,facility=local2,tag=nginx,severity=info main;

...

}

...

vhost.conf 확인

vhost안에 log 설정하는 부분이 있으면 빼주자

Logrotate 설정

logrotate 설정을 변경해준다

하루단위로 백업, 3일 단위로 rotate, mail

# >$ vi /etc/logrotate.conf

# see "man logrotate" for details

# rotate log files weekly

daily

# keep 4 weeks worth of backlogs

rotate 3

...

logrotate -> syslog 설정을 변경해준다

하루단위로 백업, 3일 단위로 rotate, mail

# >$ vi /etc/logrotate.d/syslog

/var/log/cron

/var/log/maillog

/var/log/messages

/var/log/secure

/var/log/spooler

/var/log/httpd

/var/log/httpd-access

/var/log/httpd-error

/var/log/nginx

/var/log/python

/var/log/php

/var/log/shopadmin_server_production.log # <- 필요한데서만

/var/log/shopadmin_server_development.log # <- 필요한데서만

/var/log/shopadmin_call_server_production.log # <- 필요한데서만

/var/log/shopadmin_call_server_development.log # <- 필요한데서만

/var/log/riderapp_server_production.log # <- 필요한데서만

/var/log/riderapp_server_development.log # <- 필요한데서만

/var/log/push_server_production.log # <- 필요한데서만

/var/log/push_server_development.log # <- 필요한데서만

/var/log/stat_push_server_production.log # <- 필요한데서만

/var/log/stat_push_server_development.log # <- 필요한데서만

/var/log/stat_shopadmin_call_server_production.log # <- 필요한데서만

/var/log/stat_shopadmin_call_server_development.log # <- 필요한데서만

{

daily

rotate 3

dateext

missingok

ifempty

copytruncate

create 0600 root root

sharedscripts

postrotate

/bin/kill -HUP `cat /var/run/syslogd.pid 2> /dev/null` 2> /dev/null || true

endscript

}

강제로 logrotate 실행

$ logrotate -f /etc/logrotate.d/syslog

logrotate debug 모드 (실제 실행될거 테스트)

$ logrotate -d /etc/logrotate.d/syslog

개발 언어별 syslog 사용 방법

Python

formatter를 수정하여 커스터마이징 로거 생성

Option1

이걸 사용하면 경로, 함수이름, 호출 라인을 측정할 수 있다. 하지만 기존에 사용하는 로그는 함께 동작하지 않음
사용법은 Common.getLogger.info(메시지) 형태로 사용, info 위치에는 error, crit 등 타입이 들어감

Option2 :

이걸 사용하면 syslog 와 함께 내부 로그도 같이 작동한다. 하지만 경로, 함수이름, 호출 라인은 없이 메시지만 가능
사용법은 Common.infoLog(메시지) 형태로 사용, info 위치에는 error, crit 등 타입이 들어감

import logging

import logging.handlers

# Init logger for other class

externalLogger = logging.getLogger('external')

externalLogger.setLevel(logging.DEBUG)

externalHandler = logging.handlers.SysLogHandler(address='/dev/log',facility='local3')

externalHandler.formatter = logging.Formatter('프로젝트 이름: [%(levelname)s] %(pathname)s - %(funcName)s line:%(lineno)d message:%(message)s')

externalLogger.addHandler(externalHandler)

# Init logger for Common class

internalLogger = logging.getLogger('internal')

internalLogger.setLevel(logging.DEBUG)

internalHandler = logging.handlers.SysLogHandler(address='/dev/log',facility='local3')

internalHandler.formatter = logging.Formatter('프로젝트 이름: [%(levelname)s] %(message)s')

internalLogger.addHandler(internalHandler)

# Option 1 - Common.getLogger.info(message) // <- enable pathname, funcname, lineno

def getLogger(externalCall=True):

if externalCall is True:

return externalLogger

else:

return internalLogger

# Option2 - Common.xxxxLog(message) // <- just message

def infoLog(message):

getLogger(False).info(message)

log(message)

def errorLog(message):

getLogger(False).error(message)

log(message)

def criticalLog(message):

getLogger(False).critical(message)

log(message)

사용 예제

import Common

# Option 1

Common.getLogger().info('Tez Full log teset')

Common.getLogger().critical('Tez Full log teset')

Common.getLogger().error('Tez Full log teset')

# Option 2

Common.infoLog('tez info')

Common.errorLog('tez error')

Common.critical('tez critical')

!!! 공용 class를 만들어서 사용할 경우 pathname, funcName, lineno 등을 고려하자

PHP

<?php

openlog('프로젝트이름', LOG_CONS | LOG_NDELAY, LOG_LOCAL4);

syslog(LOG_DEBUG, 'Php degug!');

syslog(LOG_INFO, 'php info');

syslog(LOG_ERR, 'php err');

syslog(LOG_CRIT, 'php crit');

closelog();

사용예제

// Debug Log

openlog(PROJECT_NAME, LOG_CONS | LOG_NDELAY, LOG_LOCAL4);

syslog(LOG_DEBUG, "$log_str");

closelog();

// Error Log

openlog(PROJECT_NAME, LOG_CONS | LOG_NDELAY, LOG_LOCAL4);

if (isset($_SERVER['HTTP_USER_AGENT']) && isset($_SERVER['REMOTE_ADDR'])) {

syslog(LOG_ERR, "{$log_str} {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");

}

else {

syslog(LOG_ERR, "{$log_str}");

}

closelog();

CodeIgniter는 config.php 에서 log_threshold 값을 2이상으로 줘야 debug 로그가 보인다

0: logging x

1: error log

2: debug log

3: info log

백업 및 데이터 정리

Log 데이터 백업

매일 주기적으로 cron.daily 에 등록하여 AWS S3 로 데이터 저장

# /etc/cron.daily/syslog_to_s3.sh

s3cmd sync --recursive /var/log/remote/ s3://tez-syslog/logs/

MySQL 데이터 정리

매일 주기적으로 DB 에서 3일이 지난 데이터는 삭제

DB가 계속 쌓이면 Loganalyzer를 확인할때 갱신속도가 엄청나게 느려지고 서버 용량이 금방 고갈난다

# /etc/cron.daily/delete_old_db_datas.sh

mysql --login-path=dumpusr Syslog -e "delete from SystemEvents where ReceivedAt < date_add(date_format( now() , '%Y-%m-%d %k:%i:%s'), interval -3 day) ORDER BY ID ASC"

삭제하는 쿼리를 돌리면 데이터 양에 따라서 속도가 느리고 cpu부하가 심하게 걸리는데, 이걸 방지하기 위해 ReceivedAt 필드에 Index를 걸어주자.

속성별 저장 위치

Remote Server

[ApacheLog]

기존 사용 경로에 저장안됨
/var/log/httpd
/var/log/httpd-access
/var/log/httpd-error

[Nginx]

/var/log/nginx

[PhpLog]

기존 사용 경로에 저장됨
/var/log/php

[PythonLog]

기존 사용 경로에 저장됨
/var/log/php

Log Server

/var/log/remote/[host]/[program]

[AppIcon] iOS 10.3 Dynamic Alternate Icon Name (동적으로 앱 아이콘 변경)

Tez.Park — Tue, 28 Mar 2017 17:52:03 +0900

Info

In iOS 10.3, the function to change app icons has been added, which allows you to change the icon without updating the app.

How to add

In Project

minimum target version : iOS 10.3
Add the alternate icons onto project

I haven't found a way to use Assets yet

Add CFBundleIcons parameter in app’s Info.plist file

reference : https://developer.apple.com/reference/uikit/uiapplication/2806818-setalternateiconname?language=objc

// Info.plist

...

<key>CFBundleIcons</key>

<dict>

<key>CFBundleAlternateIcons</key>

<dict>

<dict>

<key>CFBundleIconFiles</key>

<array>

<string>icon1</string> // <- added the alternate icon name

</array>

<key>UIPrerenderedIcon</key>

</dict>

<dict>

<key>CFBundleIconFiles</key>

<array>

</array>

<key>UIPrerenderedIcon</key>

</dict>

<dict>

<key>CFBundleIconFiles</key>

<array>

</array>

<key>UIPrerenderedIcon</key>

</dict>

<key>CFBundlePrimaryIcon</key>

<dict>

<key>CFBundleIconFiles</key>

<array>

<string>AppIcon60x60</string> // <- Assets AppIcon

</array>

</dict>

...

In Code

Setting the alertnate Icon

if ([[UIApplication sharedApplication] supportsAlternateIcons] == NO)

return;

[[UIApplication sharedApplication] setAlternateIconName:@"icon_type_1" //AlternateIcons key name

completionHandler:^(NSError * _Nullable error) {

NSLog(@"%@", [error description]);

}];

Reset to the primary icon

if ([[UIApplication sharedApplication] supportsAlternateIcons] == NO)

return;

[[UIApplication sharedApplication] setAlternateIconName:nil

completionHandler:^(NSError * _Nullable error) {

NSLog(@"%@", [error description]);

}];

Source code

https://github.com/tezpark/AlternateAppIcon-example-objC

CLLocation - 두 점사이 거리 구하기

Tez.Park — Sun, 19 Mar 2017 17:40:37 +0900

CLLocation - 두 점사이 거리 구하기

Info

GPS 사용하는 iPhone 개발을 진행하다보면 내비게이션에서 경로찾기를 하는 경우 혹은 특정 스팟까지의 거리를 구하기 위해 두 점 사이의 거리를 구해야 하는 경우들이 있다.

점 하나는 위도, 경도 값으로 이루어져 있어서 어떤 언어에서는 직접 계산을 해서 거리를 구하기도 하지만, Objective-C 에서는 CLLocation 클래스에서 distanceFromLocation: 이라는 함수를 제공해준다.

Code

CLLocation *pointA = [[CLLocation alloc] initWithLatitude:"latitudeDouble" longitude:"longitudeDouble"];

CLLocation *pointB = [[CLLocation alloc] initWithLatitude:"latitudeDouble" longitude:"longitudeDouble"];

CLLocationDistance distance = [pointA distanceFromLocation:pointB];

Layer - 그림자 넣기

Tez.Park — Sun, 19 Mar 2017 16:54:41 +0900

Info

UI 작업을 하다보면 View에 그림자를 넣어야 하는 작업이 간혹 생긴다. 이런경우 View의 layer에 있는 shadow 속성을 수정하여 간단한 그림자 처리를 할 수 있다.

UIView는 대부분의 상위 클래스이기 때문에 UIView를 상속하는 모든 class 에서 사용 가능하다.

Code

UIView* view = [[UIView alloc]init~~];

view.layer.shadowColor = [UIColor purpleColor].CGColor;

view.layer.shadowOffset = CGSizeMake(5,5);

view.layer.shadowOpacity = 1;

view.layer.shadowRadius = 1.0;

[Timezone] 한국 표준시로 변경 - CentOS7

Tez.Park — Sun, 19 Mar 2017 16:18:04 +0900

Info

리눅스를 설치할 때 Timezone을 맞추지 않으면, 기본값으로 국제 표준시인 UTC로 표시가된다.

이런 경우에는 한국 시간으로 맞춰진 ntp 를 설치하여 시간을 맞추어도 표시되는 시간이 변경되지 않는다.

따라서, 서버 자체의 Timezone 설정을 한국 표준시인 KST로 변경해 주어야 한다.

변경 방법

우선 현재 시간을 확인해보자

# date

Sun Mar 19 06:58:16 UTC 2017

Timezone 변경을 위해 서울의 timezone 정보가 담긴 파일을 찾아 서버 시간으로 연결해주자

아시아 Timezone 정보가 들어있는 폴더를 조회해보면 Seoul 파일이 존재한다

# ls /usr/share/zoneinfo/Asia

...

Seoul

...

기존에 사용중인 locatime 심볼릭 링크를 서울로 변경해주기 위해 원래 파일을 백업한 뒤 Seoul 시간대로 새로 링크를 만들어주자

# mv /etc/localtime /etc/localtime_org

# ln -s /usr/share/zoneinfo/Asia/Seoul /etc/localtime

다시 현재 시간을 확인해보면 한국 표준시인 KST로 변경이 되어있는 것을 확인할 수 있다.

# date

Sun Mar 19 16:14:59 KST 2017

버튼 클릭시 인증번호 확인 후 페이지 이동

Tez.Park — Sun, 19 Mar 2017 15:22:47 +0900

Info

웹에서 특정 액션을 하는 버튼을 구현할 경우 인증번호를 받은 후 액션을 취해햐 하는 경우가 있다.

여러가지 방법들이 있겠지만 간단하게 버튼을 클릭하면 이동할 url을 받는 javascript 함수를 호출해서 제대로 된 인증번호를 입력한 경우 페이지 이동을 하는 방법을 알아보자.

Code

Javascript

function checkPassword(url, type) {

var correctPw = "";

if (type == 0) {

correctPw = "<? echo USER_APP_PW;?>";

}

else if (type == 1) {

correctPw = "<? echo RIDER_APP_PW;?>";

}

var inputPw = prompt("인증번호 입력","");

if (inputPw == correctPw) {

location = url;

}

else {

alert("인증번호가 올바르지 않습니다");

location = "#";

}

HTML

[Upsert] 값이 없으면 Insert 하고, 값이 있으면 update 하기

Tez.Park — Sun, 15 Jan 2017 17:31:53 +0900

Info

데이터베이스에서 대량의 데이터를 등록할때 기존에 값이 저장되어 있는 경우 기존에 저장된 값이 존재하거나 Unique 키 값은 같은데 데이터가 다를 경우들이 있다. 이런 경우 insert 문만 계속 요청하면 오류가 발생하기도 하고, 이미 값이 저장되어 있으면 새로운 값으로 변경하여 저장해야하는 경우들이 있다.

이럴 때 Unique 키 값이 존재할 때 새로운 값이 들어오면 update 를 실행해주도록 하는 INSERT INTO ON DUPLICATE KEY UPDATE 쿼리를 사용하여 원활이 작업을 수행할 수 있다.

테스트를 위한 테이블 생성과 사용 방법을 알아보자

테스트를 위한 테이블 준비

테스트를 위해 users 라는 테이블을 생성 후 name 이 중복으로 저장될 수 없도록 name 를 Unique 키로 등록하자.

DROP TABLE users;

CREATE TABLE users (

name VARCHAR(25),

email VARCHAR(255)

);

ALTER TABLE users ADD UNIQUE (name);

생성 직후 테이블 데이터를 조회하면 아무 값도 등록되어 있지 않은 상태가 된다.

INSERT INTO ON DUPLICATE KEY UPDATE 사용

이제 값이 없으면 insert, 있으면 update 하는 쿼리를 사용해보자.

# Query

INSERT INTO users (NAME, email) VALUES ('tez', 'tez@tez.kr') ON DUPLICATE KEY UPDATE name='tez', email='tezpark@tez.kr';

# mysql 에서 사용

mysql> INSERT INTO users (NAME, email) VALUES ('tez', 'tez@tez.kr') ON DUPLICATE KEY UPDATE name='tez', email='tezpark@tez.kr';

Query OK, 1 row affected (0.00sec)

mysql>

위의 쿼리를 실행한 후 users 테이블을 조회하면 아래와 같이 새로운 값이 등록된다.

mysql> select * from users;

+------+------------+

| name | email |

+------+------------+

| tez | tez@tez.kr |

+------+------------+

1 row in set (0.00sec)

mysql>

다시 한번 쿼리를 사용하면 tez 라는 이름이 등록되어 있어서 tez@tez.kr 이라는 이메일 주소가 tezpark@tez.kr 로 변경된다.

# mysql 에서 사용

mysql> INSERT INTO users (NAME, email) VALUES ('tez', 'tez@tez.kr') ON DUPLICATE KEY UPDATE name='tez', email='tezpark@tez.kr';

Query OK, 2 row affected (0.00sec)

mysql> select * from users;

+------+----------------+

| name | email |

+------+----------------+

| tez | tezpark@tez.kr |

+------+----------------+

1 row in set (0.00sec)

mysql>

[Plugin] Xcode8 에서 Plugin, Package Manager 사용

Tez.Park — Sun, 15 Jan 2017 15:58:27 +0900

Info

Xcode 를 사용해서 개발할 때 작업의 효율을 높이기 위해 플러그인들을 설치하여 사용할 수 있습니다.

Xcode7 버전 까지는 Package Manager 라는 관리 툴을 사용하여 다양한 플러그인들을 Xcode에 설치하여 사용 했었고, Xcode8 부터 Apple 에서 Xcode extentions 를 이용하여 플러그인들을 사용할 수 있는 기능을 지원하기 시작했습니다.

하지만, Xcode extentions 기능이 새로 생기면서 기존에 사용하던 Package Manager를 사용할 수 없어졌고, 아직까지는 Xcode extentions 용으로 개발된 플러그인들 중에는 기존에 사용하던 플러그인들이 대부분 없어서 Package Manager를 사용하여 플러그인을 관리하고 개발 해오던 개발자들은 불편함을 겪고 있습니다.

그래서 Xcode8 버전에서 사용불가가 되어버린 Alcatraz - Package Manager 를 사용하는 방법을 소개하려고 합니다.

Xcode extentions 용 플러그인이 필요한 분들은 아래 링크로 들어가서 필요한 플러그인을 설치하여 사용하면 됩니다.

Xcode extentions List

Alcatraz - Package Manager 설치

$ curl -fsSL https://raw.githubusercontent.com/supermarin/Alcatraz/deploy/Scripts/install.sh | sh

기능 활성화 방법

update_xcode_plugins 설치

$ gem install update_xcode_plugins

# 권한문제 발생시 아래 방법 이용

$ sudo gem install update_xcode_plugins

update_xcode_plugin 실행

$ update_xcode_plugins

Unsigning Xcode

Xcode8 에서 plugin 들을 사용하기 위해 Xcode를 unsign 상태로 만들어야 한다.

$ update_xcode_plugins --unsign

unsign 작업까지 완료가 되면 package manager를 사용한 플러그인 관리가 가능해진다.

작업이 완료된 후 Xcode를 종료 후 다시 실행하면 아래 이미지에 표시된 package manager 메뉴가 생성되어있고, 이것을 실행하여 필요한 플러그인을 설치해주면된다.

Package manager 사용

사용방법은 별도로 뭔가를 해줄 필요없이 필요한 플러그인들을 Install 후 Xcode를 재시작해주면 된다. 재시작 후 기능을 load 할것인지 물어보는데 전부 load 시켜주면 플러그인 적용이 완료된다.

Xcode 복구

나중에 unsigning xcode를 되돌려야 하는 경우가 생기면 아래 명령어를 이용하여 다시 signing 모드로 변경시켜주면 된다

$ update_xcode_plugins --restore

[구축] Wordpress 개인 서버에 구축 / 권한 설정

Tez.Park — Thu, 5 Jan 2017 11:24:17 +0900

이 문서는 mysql, apache, nginx 설치, 도메인 설정에 대한 내용은 제외되어 있습니다.

해당 내용은 현재 글에 추 후 업데이트 할 예정입니다.

1. DB 생성, 설정

[root@localhost] mysql -u root -p

Password: ********

mysql> create database wordpress;

mysql> grant all privileges on wordpress.* to [id]@localhost identified by '[pwd]' with grant option;

mysql> ALTER DATABASE wordpress DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

wordpress.* wordpress 라는 DB에 속하는 모든 테이블에 권한을 부여한다는 것

[id]@localhost [id]는 사용할 사용자이름, localhost는 접속위치

‘[pwd]' 사용할 패스워드 입력

2. 워드프레스 다운로드 및 설치

다운로드

아래 사이트에서 원하는 언어 버전으로 다운로드 받아서 압출을 풀어준다.

http://wordpress.org/ (영문 버전)

http://ko.wordpress.org/ (한국어 버전)

업로드 (->서버)

로컬에서 다운로드를 받았다면 압축을 푼 파일을 서버로 전송해준다.

주의할 점은 폴더 이름을 wordpress 그대로 사용하지 말고, 다른 이름을 사용하여 추가해주자. 그래도 올리게되면 악의적인 봇이 사이트를 스캐닝하고 검색하면서 워드프레스 파일을 찾을 수 있다.

Apache or Nginx 설정

Apache 혹은 Nginx 중 사용하는 것을 선택하여 도메인 설정을 해주자

환경설정 파일 (wp-config) 만들기

http://워드프레스_도메인 (혹은 http://도메인/wordpress/wp-admin/install.php) 경로로 접속을 하면 환경설정 작업이 진행된다.

! 환경설정 파일을 생성하지 못하는 경우 과정에서 생성 방법 및 붙여넣기할 코드를 생성해주니 그대로 따라하면된다.

모든 설치가 종료되었습니다.

3. 권한 설정

워드프레스 내에서 플러그인이나 테마를 설치하려면 파일과 폴더에 쓰기 권한 설정이 필요하다.

일반적으로 워드프레스의 권한 설정 규칙은 다음과 같다

권한 설정 규칙

모든 워드프레스 파일의 소유 권한은 관리자가 되어야 함
모든 워드프레스 파일은 644 권한 (관리자:읽기/쓰기, 소유 그룹:읽기, 모든 유저:읽기) 으로 설정해야 함
모든 워드프레스 폴더는 755 권한 (관리자:읽기/쓰기/실행, 소유 그룹:읽기/실행, 모든 유저:읽기/실행) 으로 설정해야 함
워트프레스가 사용하는 계정이 리눅스 관리자 계정과 다르면 워드프레스의 파일 권한은 664, 폴더 권한은 775 로 설정해야 함
wp-config.php 파일은 600 권한 (관리자:읽기/쓰기) 으로 설정해야 함

설정파일 수정

# wp-config.php 파일 아래쪽에 추가

# FS_METHOD 를 direct 로 설정하면 워드프레스가 wp_content/와 wp_content/launguages 그리고 wp-content/upgrade/에 쓰기 권한이 있는지 리눅스 이용자 권한에 속하는지를 확인한 후 진행함. 쉽게 생각하면 폴더를 쓰기 가능하게 해주는 설정

define('FS_METHOD', 'direct');

필요한 폴더에 권한 부여 / 생성

작업은 워드프레스가 설치된 폴더에서 진행하자

# upgrade 폴더가 없는 경우 생성

$ mkdir /wp-content/upgrade

# 워드프레스 하위 폴더 권한 일괄 설정 (기본:755)

$ find ./ -type d -exec chmod 0755 {} \;

# 워드프레스 하위 파일 권한 일괄 설정 (기본:644)

$ find ./ -type f -exec chmod 0644 {} \;

워드프레스 사용 계정이 리눅스 관리자 계정과 다르다면 폴더 권한은 775, 파일 권한은 664 로 설정하자

[APNs] Push notification 등록 (iOS10 대응)

Tez.Park — Sun, 11 Dec 2016 17:45:34 +0900

Summary

APNs 를 사용하여 푸쉬 서비스를 이용할 경우 소스코드 내에 푸쉬 서비스 등록 및 푸쉬를 받았을 경우 처리할 수 있는 delegate 를 구현해 주어야 한다.

iOS10 부터 UNUserNotification 을 사용하여 서비스 등록 및 처리 방법이 변경되었기 때문에 iOS10 버전과 하위버전을 같이 처리할 수 있도록 적용해 주어야 한다.

푸시 서비스 등록 및 처리

/************

AppDelegate.h

*************/

#import <UserNotifications/UserNotifications.h> // 추가 ( >= iOS10)

// UNUserNotificationCenterDelegate 를 추가

@interface AppDelegate : UIResponder <UIApplicationDelegate, UNUserNotificationCenterDelegate>

...

/************

AppDelegate.m

*************/

...

#define isOSVersionOver10 ([[[[UIDevice currentDevice].systemVersion componentsSeparatedByString:@"."] objectAtIndex:0] integerValue] >= 10)

...

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

...

// 푸시 서비스 초기화 함수를 호출

[self initializeRemoteNotification];

...

}

#pragma mark - Initialize Remote Notification

- (void)initializeRemoteNotification {

if(isOSVersionOver10) { // iOS10 이상

UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];

center.delegate = self;

[center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error){

if( !error ) {

// 푸시 서비스 등록 성공

[[UIApplication sharedApplication] registerForRemoteNotifications];

}

else {

// 푸시 서비스 등록 실패

}];

}

else { // iOS10 하위버전

if ([[UIApplication sharedApplication] respondsToSelector:@selector(isRegisteredForRemoteNotifications)]) {

[[UIApplication sharedApplication] registerUserNotificationSettings:[UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge) categories:nil]];

[[UIApplication sharedApplication] registerForRemoteNotifications];

}

#pragma mark - Get Device Token

// 푸시에 사용할 디바이스 토큰을 받아오는 부분

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

NSMutableString *tokenHex = [NSMutableString stringWithString:[deviceToken description]];

[tokenHex replaceOccurrencesOfString:@"<" withString:@"" options:0 range:NSMakeRange(0, [tokenHex length])];

[tokenHex replaceOccurrencesOfString:@">" withString:@"" options:0 range:NSMakeRange(0, [tokenHex length])];

[tokenHex replaceOccurrencesOfString:@" " withString:@"" options:0 range:NSMakeRange(0, [tokenHex length])];

NSLog(@"Token origin : %@", deviceToken);

NSLog(@"Token : %@", tokenHex);

}

// iOS9 이하 푸시 Delegate

#pragma mark - Remote Notification Delegate for <= iOS 9.x

- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings {

[application registerForRemoteNotifications];

}

// 푸시 데이터가 들어오는 함수

-(void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {

NSLog(@"Remote notification : %@",userInfo);

}

// 푸시 서비스 등록 실패시 호출되는 함수

-(void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {

NSLog(@"Error : %@",error);

}

// iOS10 이상 푸시 Delegate

#pragma mark - UNUserNotificationCenter Delegate for >= iOS 10

// 앱이 실행되고 있을때 푸시 데이터 처리

- (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {

NSLog(@"Remote notification : %@",notification.request.content.userInfo);

//푸시 배너를 띄워준다

completionHandler(UNNotificationPresentationOptionAlert | UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionSound);

}

// 앱이 백그라운나 종료되어 있는 상태에서 푸시 데이터 처리

- (void)userNotificationCenter:(UNUserNotificationCenter *)center didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)())completionHandler{

NSLog(@"Remote notification : %@",response.notification.request.content.userInfo);

completionHandler();

}

iOS10 부터는 소스코드 추가 이외에 프로젝트 설정에서 Push Notificaiton 옵션을 활성화 해주어야 한다

옵션을 활성화 해주면 아래와 같이 entitlements 파일이 생성될 것이다.

이렇게 해주면 모든 푸시 서비스 등록 작업이 마무리된다.

[mysql_config_editor] 암호화된 인증정보로 로그인

Tez.Park — Sun, 11 Dec 2016 16:38:18 +0900

Summary

커맨드라인에 계정정보가 노출되면 아래와 같은 경고 발생

Warning: Using a password on the command line interface can be insecure.

커맨드 혹은 스크립트에서 계정 정보를 노출 하는건 정보가 유출 될 수 있으므로 로그인 파일을 생성한 후 사용하면 좋다.

mysql_config_editor?

MySQL 5.6.6 이상부터 사용가능한 Utility로 암호화된 로그인 파일인 .mylogin.cnf 에 합접적인 인증 정보를 저장하여 사용하는 Utility 이다.

mysql_config_editor 명령어는 .mylogin.cnf 파일을 암호화하여 내용을 읽을 수 없게 만들고, client 프로그램에서 해독된 정보만 메모리상에 존재하므로 패스워드 정보를 보호할 수 있다.

접속 정보 생성

자세한 설명을 생략하고 바로 접속 정보를 생성하는 방법을 알아보자

$ mysql_config_editor set --login-path=[name] --host=[hostname] --user=[username] --password —port=[port]

위의 명령어를 입력하면 비밀번호를 입력한 후 myinfo.cnf 파일에 접속 정보가 등록된다.

사용자 입력 항목들은 아래와 같다.

[name] : 접속시 사용할 이름

[hostname] : DB 호스트네임

[username] : DB 접속 아이디

[port] : 호스트의 포트번호

등록된 인증 정보 확인

$ mysql_config_editor print --all

[tez]

user = root

password = *****

host = localhost

port = 3306

print 옵션을 사용하여 등록정보를 출력하면 비밀번호 부분은 가려진채로 정보를 보여준다

등록한 인증 정보로 MySQL 사용

# 기존 방법

$ mysql -u [username] -p

# 변경 방법

$ mysql --login-path=[name]

기존에 사용하던 -u [username] -p 대신 —login-path=[name] 옵션을 사용하여 mysql 관련 동작을 처리하면 된다

mysql, mysqldump 등 모두 이렇게 사용하면 된다.

등록된 인증 정보 삭제

등록되어있는 인증정보를 삭제하는 방법은 특정 정보만 삭제하는 방법과 전체 정보를 삭제하는 방법 두가지가 있다.

# 특정 접속 정보만 삭제

$ mysql_config_editor remove —login-path=[name]

# 전체 정보를 삭제

$ mysql_config_editor remove

[Command] RHEL7 systemctl 명령어들

Tez.Park — Sun, 11 Dec 2016 16:30:06 +0900

RHEL6 `service` > RHEL7 `systemctl`

RHEL6 의 service 명령어가 RHEL7 에서는 systemctl 명령어로 대체됨

# 상태표시 서비스 단위

$ systemctl status [service_name]

# 상태표시 전체

$ systemctl list-units --type service

# 상태표시 전체(생략형)

$ systemctl --type service

# 서비스 시작

$ systemctl start [service_name]

# 서비스 종료

$ systemctl stop [service_name]

# 서비스 강제 종료

$ systemctl kill -s 9 [service_name]

# 서비스 재시작

$ systemctl restart [service_name]

# 서비스 설정 반영

$ systemctl reload [service_name]

RHEL6 `chkconfig` > RHEL7 `systemctl`

RHEL6의 chkconfig 명령어가 RHEL7 에서는 systemctl 명령어로 대체됨

# 전체 서비스 상태 보기

$ systemctl list-unit-files --type service

# 서비스 추가 (chkconfig --addd)

$ systemctl daemon-reload

# /etc/systemd/system 하위에 존재하는 service 설정파일을 변경한 경우에 systemd 에 반영하는 용도로도 사용되어짐

# 서비스 상태 확인

$ systemctl is-enabled [service_name]

# 서비스 enable

$ systemctl enable [service_name]

# 서비스 disable

$ systemctl disable [service_name]

[Log] 로그 확인 옵션들

Tez.Park — Sun, 11 Dec 2016 15:56:24 +0900

히스토리 검색 (기본)

$ git log

# Output

commit a32b4d3a362c9c9fb6adfd0aae573bf8223ed774

Author: tez <tez@tez.kr>

Date: Sun Dec 11 15:45:12 2016 +0900

2nd commit

commit cae1239cdda71d58bcc1315ef95dcb94a5df3cac

Author: tez <tez@tez.kr>

Date: Sun Dec 11 15:44:46 2016 +0900

1st commit

각 커밋의 diff 결과 표시

$ git log -p

# Output

commit a32b4d3a362c9c9fb6adfd0aae573bf8223ed774

Author: tez <tez@tez.kr>

Date: Sun Dec 11 15:45:12 2016 +0900

2nd commit

diff --git a/test.file b/test.file

index 3b18e51..d0c4c4f 100644

--- a/test.file

+++ b/test.file

@@ -1 +1,3 @@

hello world

+text text blabla

commit cae1239cdda71d58bcc1315ef95dcb94a5df3cac

Author: tez <tez@tez.kr>

Date: Sun Dec 11 15:44:46 2016 +0900

1st commit

diff --git a/test.file b/test.file

new file mode 100644

index 0000000..3b18e51

--- /dev/null

+++ b/test.file

@@ -0,0 +1 @@

+hello world

특정 히스토리 개수만 표시

$ git log -[count]

# ex) git log -2

# Output

commit 15b0e2a2a3caf8e6d5323e736158c9eed3f81d80

Author: Taesun Park <perfect@foodfly.co.kr>

Date: Sun Dec 11 15:45:50 2016 +0900

3rd commit

commit a32b4d3a362c9c9fb6adfd0aae573bf8223ed774

Author: Taesun Park <perfect@foodfly.co.kr>

Date: Sun Dec 11 15:45:12 2016 +0900

2nd commit

[Push] 강제 푸시

Tez.Park — Sun, 11 Dec 2016 15:53:27 +0900

저장소가 꼬이거나 하는 경우에 Push가 되지 않을때 사용하는 방법

branch 이름 앞에 +를 붙여서 강제 Push를 한다

$ git push origin +[branch]

[Disk] 디스크, 파일, 폴더 용량 확인

Tez.Park — Sun, 11 Dec 2016 15:41:00 +0900

df

디스크 용량을 확인할때 사용

옵션들

-h 용량을 사람이 보기 쉬운 단위로 표시해준다. (1m를 1,048,576단위로 계산, h는human의 약자 )
-H 용량을 사람이 보기 쉬운 단위로 표시해준다. (1m를 1,000,000단위로 계산)
-k 용량을 킬로바이트 단위로 표시한다.
-i i노드의 사용정보를 표시한다.

$ df -[option]

# Example

$ df -h

-----------------------------------------------------

Filesystem Size Used Avail Use% Mounted on

/dev/xvda1 30G 877M 30G 3% /

devtmpfs 478M 0 478M 0% /dev

tmpfs 496M 0 496M 0% /dev/shm

tmpfs 496M 13M 484M 3% /run

tmpfs 496M 0 496M 0% /sys/fs/cgroup

tmpfs 100M 0 100M 0% /run/user/1000

du

디렉토리나 파일의 용량을 확인할때 사용

옵션들

-a 디렉토리 이외의 파일에 대해서도 표시한다.
-l 링크를 포함해서 계산한다.
-c 모든 용량을 합을 표시한다.
-k 용량을 KB단위로 표시한다.
-m 용량을 MB단위로 표시한다.
-s 지정한 파일이나 디렉토리만의 합계를 표시한다.
-S 서브디렉토리를 포함해서 집계한다.

$ du -[options] [dir]

# Example

$ du -csh ./*

---------------

4.0K ./Dir1

4.0K total

[Migration] Paravirtual(PV) to Hardware Virtual Machine(HVM)

Tez.Park — Mon, 26 Sep 2016 01:33:34 +0900

This article is for users that change AWS region around the world.

Base

CentOS

Issue

The problem occurs because specific region does not have PV Instance.

Fixing

Resolved by copying the file with rsync after mounting PV Volume and HVM Volume.

info

Original PV Instance : orig_pv_instance
New HVM Instance : new_hvm_instance
Original PV volume : orig_pv_vol
Duplicated PV Volume : dup_pv_vol
New HVM Volume : new_hvm_vol

Migrating the EC2 Instance

1. Duplication PV volume that want to move. (Using the Snapshot)

Volumes menu -> Select the PV instance
Right click -> Create Snapshot (pv_snap)
Snapshots menu -> Select ‘pv_snap’ and Created Volume
Setting up items and check availability zone

AZ shall be the same as the place you want to move

2. Create HVM Instance such as PV instance OS

3. Duplication HVM volume using Step 1.

4. Copied PV Volume(dup_pv_vol) and HVM Volume(new_hvm_vol) attach to the PV Instance(orig_pv_instance)

Volume menu -> Select the dup_pv_vol
Right click -> Attach Volume

Instance : orig_pv_instance
Device : /dev/sdm (have your way)

Volume menu -> Select the new_hvm_vol
Right click -> Attach Volume

Instance : orig_pv_instance
Device : /dev/sdo (have your way)

5. PV Instance lauch and connect

6. Check volume size and Mount volumes

Ensure PV and HVM Volumes attachment

using $ fdisk -l

If volume size not correct, follow step 2.
And when size is correct to follow next step.

PV and HVM volumes mount.

$ mount [pv volume dir] // Want to mount the pv directory.
$ mount [hvm volume dir] // Want to mount the hvm directory.

Modify volume size (pv and hvm)

$ fdisk [volume] // Want to modify the volume.

Command (m for help) : u
Command (m for help) : p
Command (m for help) : d
Command (m for help) : n
Command action : p
Partition number (1-4) : 1
First sector (17-41943039, default 17): 2048
Last sector, +sectors or +size{K,M,G} (2048-41943039, default 41943039): <Enter>
Command (m for help) : p
Command (m for help) : a
Partition number (1-4) : 1
Command (m for help) : w

$ reboot
mount check

$ dh -h
If not mounted, follow next step.

$ fdisk -l
$ mount [dir] // Want to mount the directory.

change to volume size.

$ resize2fs [dir] // Want to change size the directory.

7. Copying Files using rsync

It takes long time.
Working instance must have all the authorities that to use at Source PV Volume.
Make use using the following script.

#pv_to_hvm.sh

#!/bin/sh

cd /HVM

cp /HVM/etc/fstab /root/

for dir in $(ls -l | awk '{print $NF}'| egrep -v 'boot|lib'); do rm -rf $dir; echo "deleted $dir"; done

rm -rf /HVM/lib64

cd /HVM/lib/

cp -rpf /HVM/lib/modules /root/modules_bkp/

rm -rf /HVM/lib/*

mkdir /HVM/lib/modules

chmod -w /HVM/lib/modules

cp -rpf /root/modules_bkp/ /HVM/lib/modules/

rm -rf /PV/boot

rsync -aAXHPv /PV/ /HVM/

rm -rf /HVM/.auto*

mv /HVM/etc/fstab /HVM/etc/bak_fstab

cp /root/fstab /HVM/etc/

8. Volume umount

Make sure you used the image files in the configuration file before you umount the Volume

open /HVM/boot/grub/grub.conf file in /HVM/lib/modules.
check images

title image file
kernel image file
initrd image file

PV and HVM volume amount

9. Stop the PV Instance(orig_pv_instance) and detach the HVM Volume(new_hvm_vol)

10. Detach root volume in the HVM Instance(new_hvm_instance)

11. Attach to the working HVM volume(new_hvm_volume) in HVM Instance(new_hvm_instance)

12. Launch HVM Instance(new_hvm_instance)

[NTP] 시간 동기화 자체 서버 구축 / 클라이언트 설정

Tez.Park — Mon, 26 Sep 2016 01:21:47 +0900

[NTP 서버 구축]

ntp 데몬 설치

ntp 사용을 위해 서버에 ntp 데몬을 설치

$ yum install -y ntp

ntp 포트 열기

ntp는 udp 123 포트를 사용하기 때문에 방화벽 혹은 Secutiry group 등에 udp123 포트를 열어주자

inbound 룰에 udp 123포트가 열려야한다. (source 0.0.0.0/0)
인스턴스의 보안 그룹 규칙은 포트 123(NTP)에서 아웃바운드 UDP 트래픽을 허용해야 하고, 네트워크 ACL 규칙은 포트 123에서 인바운드와 아웃바운드 UDP 트래픽을 모두 허용해야 한다.

ntp 설정 파일 수정

Client 접근을 허용하기 위해 restrict 설정을 추가

restrict [client IP] mask 255.255.255.0 nomodify notrap

사용할 외부 ntp 서버주소를 추가해준다

server [ntp서버 주소]

로컬 타임 서버로 동작하기 위해 127.127.1.0 서버 추가
stratum 값을 설정해준다

값이 너무 낮으면 (Server dropped: strata too high) 이런 에러가 발생한다.
적당히 낮은 수치로 해주자.
1 혹은 2는 외부 ntp 서버값이므로 사용하지 말자

아래 conf 파일은 설정 완료된 상태

$ vi /etc/ntp.conf

# Permit time synchronization with our time source, but do not

# permit the source to query or modify the service on this system.

restrict default kod nomodify notrap nopeer noquery

restrict -6 default kod nomodify notrap nopeer noquery

# Permit all access over the loopback interface. This could

# be tightened as well, but to do so would effect some of

# the administrative functions.

restrict 127.0.0.1

restrict -6 ::1

# Hosts on local network are less restricted.

#restrict 192.168.1.0 mask 255.255.255.0 nomodify notrap

restrict 172.31.0.0/16 mask 255.255.255.0 nomodify notrap

# Use public servers from the pool.ntp.org project.

# Please consider joining the pool (http://www.pool.ntp.org/join.html).

#server 0.centos.pool.ntp.org iburst

#server 1.centos.pool.ntp.org iburst

#server 2.centos.pool.ntp.org iburst

server kr.pool.ntp.org

server asia.pool.ntp.org

includefile /etc/ntp/crypto/pw

# Key file containing the keys and key identifiers used when operating

# with symmetric key cryptography.

keys /etc/ntp/keys

# Undisciplined Local Clock. This is a fake driver intended for backup

# and when no outside source of synchronized time is available.

server 127.127.1.0 # local clock

fudge 127.127.1.0 stratum 3

ntp daemon 부팅시 실행되게 서비스 등록, 시작

#centos 6

$ chkconfig ntpd on

$ service ntpd restart

#centos 7

$ systemctl enable ntpd

$ systemctl restart ntpd

ntp daemon 상태 확인

LOCAL이 표시되면 ntp 서버로 준비 된것임

$ ntpq -p

remote refid st t when poll reach delay offset jitter

==============================================================================

114.207.245.166 141.223.182.106 2 u 33 64 1 4.328 -5.253 0.000

202-65-114-202. 203.160.128.66 2 u 32 64 1 99.512 -1.440 0.000

*LOCAL(0) .LOCL. 3 l 31 64 1 0.000 0.000 0.000

[Client 설정] - ntp daemon

ntp 설정 파일 수정

다른 서버들은 모두 막아준다

$ vi /etc/ntp.conf

...

# Use public servers from the pool.ntp.org project.

# Please consider joining the pool (http://www.pool.ntp.org/join.html).

#server 0.centos.pool.ntp.org iburst

#server 1.centos.pool.ntp.org iburst

#server 2.centos.pool.ntp.org iburst

server [내부 ntp서버 IP]

...

ntp daemon 부팅시 실행되게 서비스 등록, 시작

#centos 6

$ chkconfig ntpd on

$ service ntpd restart

#centos 7

$ systemctl enable ntpd

$ systemctl restart ntpd

[Client 설정] - cron.daily

!! Client 서버에서는 내부 ntp 서버와 cron으로 시간을 동기화 하기 때문에 ntpdaemon 서비스는 종료

cron.daily 사용

쉘 스크립트 생성

$ vi /etc/cron.daily/time-sync

#!/bin/bash

/usr/sbin/ntpdate [내부 ntp서버 IP] && /sbin/clock -w # [내부 ntp서버 IP] -> xxx.xxx.xxx.xxx, 대괄호 없이

실행 권한 부여

$ chmod 755 /etc/cron.daily/time-sync

매일 새벽 4시에 동기화 스크립트를 수행한다

[NTP] NTP daemon / crontab으로 시간 동기화

Tez.Park — Mon, 26 Sep 2016 01:19:33 +0900

[NTP daemon 사용]

ntp 데몬 설치

ntp 사용을 위해 서버에 ntp 데몬을 설치

$ yum install -y ntp

ntp 포트 열기

ntp는 udp 123 포트를 사용하기 때문에 방화벽 혹은 Secutiry group 등에 udp123 포트를 열어주자

ntp 설정 변경

$ vi /etc/ntp.conf

기존 시간 서버를 막고 한국 기준 ntp 서버들을 추가

...

#server 0.centos.pool.ntp.org iburst

#server 1.centos.pool.ntp.org iburst

#server 2.centos.pool.ntp.org iburst

#server 3.centos.pool.ntp.org iburst

server 3.kr.pool.ntp.org

server 1.asia.pool.ntp.org

server 2.asia.pool.ntp.org

...

ntp daemon 부팅시 실행되게 서비스 등록, 시작

#centos 6

$ chkconfig ntpd on

$ service ntpd restart

#centos 7

$ systemctl enable ntpd

$ systemctl restart ntpd

ntp daemon 상태 확인

$ ntpq -p

remote refid st t when poll reach delay offset jitter

==============================================================================

send.mx.cdnetwo .INIT. 16 u - 256 0 0.000 0.000 0.000

li1440-241.memb .INIT. 16 u - 256 0 0.000 0.000 0.000

*LOCAL(0) .LOCL. 3 l - 64 377 0.000 0.000 0.000

[Crontab 사용]

ntpdate 설치

$ yum install -y ntpdate

crontab에 등록해서 사용자가 정하는 시간대에 동기화를 하도록 하자

$crontab -e

...

# 매일 새벽 1시에 시간 동기화

00 4 * * * ntpdate kr.pool.ntp.org

[cron.daily 사용]

쉘 스크립트를 생성해서 cron

쉘 스크립트 생성

$ vi /etc/time-sync.ntp

#!/bin/bash

/usr/sbin/ntpdate -b -s kr.pool.ntp.org && /sbin/clock -w

실행 권한 부여

$ chmod 755 time-sync.ntp

작성한 파일을 /etc/cron.daily/ 로 복사 (매일 새벽 4시에 동기화 스크립트를 수행한다)

[ntpdate 사용법] - 번외

ntpdate는 시간을 바로 동기화 시킬 때 사용하는 명령어로 생각하면됨

기본 사용법과 옵션들

ntp서버와 시간 동기화

$ ntpdate kr.pool.ntp.org

ntp서버와 강제 시간 동기화

ntpdate는 옵션(-b, -B)을 지정하지 않으면 현재 시스템 시간과 차이가 128ms 이상이면 settimeofday()을, 이내이면 adjtime()을 사용한다. 강제적으로 ntpdate -b 로 settimeofday()를, ntpdate -B로 adjtime()를 사용할 수 있다.

$ ntpdate -b kr.pool.ntp.org

$ ntpdate -B kr.pool.ntp.org

디버깅 모드

$ ntpdate -d kr.pool.ntp.org

udp 123포트를 사용못할때 다른포트를 사용해서 동기화

ntpdate -u kr.pool.ntp.org

[Logrotate] 강제로 갱신, Debug모드

Tez.Park — Mon, 26 Sep 2016 01:17:26 +0900

강제로 logrotate 수행

[root@tez ~]# logrotate -f /etc/logrotate.conf

logrotate debug 모드

[root@tez ~]# logrotate -d /etc/logrotate.conf

[Service] Shell script를 python service로 구동하기

Tez.Park — Mon, 26 Sep 2016 01:06:13 +0900

CenOS6

upstart 명령 이용

/etc/init 하에 service_name.conf 로 작성
start/stop/restart [service_name] 으로 실행 가능
chkconfig [service_name] on 으로 부팅시 실행 가능

service_name.conf 파일

## upstart configuration file example

chdir /[python folder path]

env ENVIRONMENT=development

exec python [python file].py $ENVIRONMENT 2>&1

post-stop exec sleep 1

respawn

service 실행

$ cd /etc/init

/etc/init$ start [service_name]

CentOS7

systemd 명령 이용

명령을 바로 실행할 수 없기 때문에 python 실행명령은 shell script로 작성
/etc/systemd/system 밑에 service_name.service 로 작성
설정 파일 생성/변경 후 systemctl daemon-reload 로 로딩
service [service_name] start/stop/restart 로 실행

systemctl start/stop/restart [service_name] 과 같다

systemctl status [service_name] 으로 상태/로그 조회
systemctl enable [service_name] 으로 부팅시 실행 가능

service_name.service파일

## systemd configuration file example

[Unit]

Description= example server service

After=network.target

[Service]

Type=simple

WorkingDirectory=/[python folder path]/

ExecStart=/[python folder path]/start.sh development

Restart=always

[Install]

WantedBy=multi-user.target

start.sh 파일

#!/bin/sh

python /[python folder path]/ExampleServer.py $1

service 실행

$ systemctl start [service_name]

[User] User 추가/Root권한/비밀번호 인증 활성화

Tez.Park — Mon, 26 Sep 2016 01:03:38 +0900

유저 추가

$ sudo su - #root로그인

$ adduser [username]

$ passwd [username] #패스워드 입력

Root 권한 설정

$ visudo

## Allow root to run any ~~ 밑에

[username] ALL=(ALL) NOPASSWD:ALL #유저 추가

$ service sshd restart # 서비스 재시작

로그인시 비밀번호 인증 활성화

$ cd /etc/ssh

/etc/ssh$ vi sshd_config

PasswordAutentication yes #변경 (로그인시 비밀번호로 인증 활성화)

$ service sshd restart #서비스 재시작

[SSH] PW없이 로그인

Tez.Park — Mon, 26 Sep 2016 01:01:57 +0900

1. ssh key 생성 (없는 경우만)

[local@tez ~]$ ssh-keygen -t rsa

2. 서버로 로컬에서 만든 공개키 복사

[local@tez ~]$ scp ~/.ssh/id_rsa.pub [id]@[address]:id_rsa.pub

3. 서버 접속 (일반접속)

[local@tez ~]$ ssh [id]@[address]

4. 로그인후 개인폴더에 .ssh 폴더 생성 (있으면 pass)

[server@tez ~]$ mkdir .ssh

5. .ssh폴더 권한 변경

[server@tez ~]$ chmod 700 .ssh

6. 공개키 인증키 목록에 추가

[server@tez ~]$ cat id_rsa.pub >> .ssh/authorized_keys

7. 필요없는 공개키 제거

[server@tez ~]$ rm -f id_rsa.pub

8. 인증키 목록 권한 수정

[server@tez ~]$ chmod 644 .ssh/authorized_keys

9. 서버 접속

[local@tez ~]$ ssh -i ~/.ssh/id_rsa [id]@[address]

[Service] Service list

Tez.Park — Mon, 26 Sep 2016 00:59:10 +0900

리눅스에서 실행중인 서비스 목록 확인

service --status-all

[root@tez ~]# service --status-all

acpid (pid 961)를 실행하고 있습니다..

asterisk (pid 1068)를 실행하고 있습니다..

atd (pid 1116)를 실행하고 있습니다..

auditd (pid 878)를 실행하고 있습니다..

crond (pid 1083)를 실행하고 있습니다..

...

[Semanage] ssh 특정 포트 접근 제어

Tez.Park — Mon, 26 Sep 2016 00:58:06 +0900

semanage는 SELinux 의 보안 정책을 조회하고 추가/변경/삭제 할 수 있는 명령

SSH custom port 설정 (2020로 가정)

$ cd /etc/ssh

/etc/ssh$ vi sshd_config

#Port 22 =>부분 주석해제 후 custom port 번호로 변경

#ListenAddress 0.0.0.0 =>부분 주석해제

$ semanage port -a -t ssh_port_t -p tcp 2020

$ semanage port -l | grep ssh # 설정 확인

[Process] 특정 프로세스가 사용하는 개수 확인

Tez.Park — Mon, 26 Sep 2016 00:53:43 +0900

$ ps -ef | grep [service name]

root 789 1 0 Jun16 ? 00:05:46 /usr/bin/python -Es /usr/sbin/tuned -l -P

root 5078 10056 0 22:24 pts/0 00:00:00 grep --color=auto python

root 6629 6628 0 Jun21 ? 01:01:29 python3.4 /root/xxx-server/XxxServer.py production

root 27645 1 0 18:43 ? 00:00:00 /bin/sh /root/xxx-app-server-python/start.sh production

root 27647 27645 1 18:43 ? 00:04:09 python3.4 /root/xxx-app-server-python/XxxAppServer.py production

여기서 나온 process 번호를 proc 폴더에서 검색 후 fd 폴더에서 개수 확인

$ cd /proc/[process no]/fd

$ ls -l | wc -l

[Port] Check port list in linux

Tez.Park — Mon, 26 Sep 2016 00:51:15 +0900

리눅스에서 사용중인 포트 목록 확인

netstat -atlpvn

[root@tez ~]# netstat -atlpvn

Active Internet connections (servers and established)

Proto Recv-Q Send-Q Local Address Foreign Address State PID/Program name

tcp 0 0 127.0.0.1:199 0.0.0.0:* LISTEN 980/snmpd

tcp 0 0 0.0.0.0:6379 0.0.0.0:* LISTEN 916/redis-server *

...

[MySQL] Install MySQL

Tez.Park — Mon, 26 Sep 2016 00:45:34 +0900

Install MySQL

mysql 설치, 서비스 등록

CentOS7 부터는 데이터베이스가 Mariadb로 변경되어서 MySQL을 바로 yum으로 설치가 불가능기 때문에 mysql을 yum에 등록 후 설치해준다

#yum에 mysql 등록

$ yum -y install http://dev.mysql.com/get/mysql-community-release-el7-5.noarch.rpm

# mysql 인스톨

$ yum -y install mysql-community-server

# mysql 실행

$ systemctl start mysqld

# 시스템에 등록 (부팅시 자동실행)

$ systemctl enable mysqld

Change password

최초 설치시에만 된다.

$ mysql_secure_installation #암호 설정모드

$ /usr/bin/mysqladmin -u root password '[변경할 패스워드]'

sudo grep 'temporary password' /var/log/mysqld.log

$ sudo mysql_secure_installation

Set Characterset

mysql의 기본 설정값이 latin1 로 되어 있어서 utf8 로 바꿔주자. 바꾸지 않으면 한글깨짐등 문제가 생길 수 있다.

Characterset 변경 (/etc/my.cnf 파일)

$ vi /etc/my.cnf

[mysqld]

# 아래 두개 추가

character-set-server=utf8

collation-server=utf8_bin

#...

mysql 재시작

$ systemctl restart mysqld

[Log] Apache log format

Tez.Park — Sun, 25 Sep 2016 17:33:48 +0900

Syntax : LogFormat format [nickname]

Default: LogFormat "%h %l %u %t \"%r\" %s %b"

LogFormat은 CLF 로그 포맷과 별도로 관리자가 정의한 로그 파일 형식을 만들기 위해서 사용이 되어진다.

다음 표는 로그 포맷에서 사용이 되어지는 변수들이다.(포맷에 대한 조금 더 자세한 내용은 Apache HTTP Server Project 를 참조)

변수 설명

------------------------------------------------------------------------

%% : 퍼센트 기호

%...a : 요청한 클라이언트의 IP주소(원격 IP주소)

%...A : 로컬 IP 주소(서버 IP주소)

%...B : HTTP 헤더를 제외한 전송 바이트의 수

%...b : HTTP 헤더를 제외한 전송 바이트의 수. 전송 바이트가 없는 경우에 CLF에서 0으로

표기하지 않고 '-'로 표기한다.

%...{Foobar}C : 서버가 수신한 요청에서 Foobar 쿠키의 내용

%...D : 요청을 처리하는데 걸린 시간(마이크로초 단위)

%...{Foobar}e : Foobar라는 환경 변수

%...f : 파일명

%...h : 요청한 원격 호스트(예:210.210.210.10)

%...H : 요청 프로토콜(예:HTTP/1.1)

%...{Foobar}i : Foobar의 내용-서버에 요청을 할 때의 헤더에 있는 내용

%...l : 리모트 로그인 이름(identd 데몬으로 부터 얻어 올 수 있을 때, 없을 경우 - 표시)

%...m : 요청 메소드(예:GET 또는 POST)

%...{Foobar}n : 다른 모듈에서 "Foobar"의 내용

%...{Foobar}o : Foobar의 내용 - 응답에서 헤더에 있다

%...p : 응답을 처리해준 서버의 포트(예:80)

%...P : 응답을 처리해준 차일드 프로세스의 프로세스 번호(예:14633)

%...{format}P : 요청을 서비스하는 자식의 프로세스 ID 혹은 쓰레드 ID. format에는 pid와 tid가

가능하다

%...q : 쿼리 스트링(예:http://www.webnkorea.com/server-status?refresh=5라고 하면

'?refresh=5' 가 기록된다. 쿼리 스트링이 없으면 빈 공백이 들어간다)

%...r : 요청을 할때의 첫 라인(index.html을 요청을 했다면 다음과 같이 기록 된다.

(GET/HTTP/1.1)

%...s : 요청에 대한 서버의 상태

%...t : 요청을 받은 시간, CLF에서 시간과 같다(영어로 표기됨)

%...{format}t : 주어진 형식의 시간. strtime(3) 포맷으로 주어져야 한다.

%...T : 서버가 요청을 처리하는 데 걸리는 시간(초)(예:1초 미만일 경우 '0'으로 표기)

%...u : 원격 사용자 이름

%...U : 요청한 URL

%...v : 요청에 대해서 처리를 한 서버 이름(예:www.webnkorea.com)

%...V : UseCanonicalName 설정에 따른 요청에 대해서 처리한 서버 이름

%...I : 요청과 헤더를 포함한 수신 바이트수로 0일 수 없다.(영문자 아이임)

(사용하려면 mod_logio가 필요하다)

%...O : 헤더를 포함한 송신 바이트수로 0일 수 없다.(사용하려면 mod_logio가 필요하다)

LogForamt 지시자에서 위의 변수들을 사용해서 마음대로 로그 포맷을 바꿀 수 있다. 자신이 모니터링하고 싶은 정보만을 로그에 기록함으로써 가독성을 늘리고 데이터의 크기를 줄일 수 있다.

[Java] Install Java (JDK/JRE) on CentOS/RHEL

Tez.Park — Sun, 25 Sep 2016 17:24:17 +0900

Download Latest Java Archive

Official download page : http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

64Bit 다운로드, 압축해제

$ cd /opt/

$ wget --no-cookies --no-check-certificate --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F; oraclelicense=accept-securebackup-cookie" "http://download.oracle.com/otn-pub/java/jdk/8u91-b14/jdk-8u91-linux-x64.tar.gz"

$ tar xzf jdk-8u91-linux-x64.tar.gz

Java설치 / 기본 JDK변경

alternatives 명령어 : 여러 버전의 JDK가 설치 되어 있을때 기본 JDK를 변경해 주는 명령어

$ cd /opt/jdk1.8.0_91/

$ alternatives --install /usr/bin/java java /opt/jdk1.8.0_91/bin/java 2

$ alternatives --config java

There are 3 programs which provide 'java'.

Selection Command

-----------------------------------------------

* 1 /opt/jdk1.7.0_71/bin/java

+ 2 /opt/jdk1.8.0_45/bin/java

3 /opt/jdk1.8.0_77/bin/java

4 /opt/jdk1.8.0_91/bin/java

Enter to keep the current selection[+], or type selection number: 4

javac와 jar 명령어 경로를 대체해준다

$ alternatives --install /usr/bin/jar jar /opt/jdk1.8.0_91/bin/jar 2

$ alternatives --install /usr/bin/javac javac /opt/jdk1.8.0_91/bin/javac 2

$ alternatives --set jar /opt/jdk1.8.0_91/bin/jar

$ alternatives --set javac /opt/jdk1.8.0_91/bin/javac

설치된 Jave 버전 확인

시스템에서 사용되는 java 버전 확인

$ java -version

java version "1.8.0_91"

Java(TM) SE Runtime Environment (build 1.8.0_91-b14)

Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode)

환경 변수 변경

Setup JAVA_HOME, JRE_HOME, PATH variable

$ export JAVA_HOME=/opt/jdk1.8.0_91

$ export JRE_HOME=/opt/jdk1.8.0_91/jre

$ export PATH=$PATH:/opt/jdk1.8.0_91/bin:/opt/jdk1.8.0_91/jre/bin

/etc/enviroment 파일에 환경 변수 내용이 추가되면 system이 부팅될때 자동으로 로딩됨

[Hostname] Change hostname

Tez.Park — Sun, 25 Sep 2016 17:17:02 +0900

CentOS 6

[root@tez ~]# hostname [hostname] #즉시 적용 / 재부팅시 초기화

[root@tez ~]# vi /etc/sysconfig/network

HOSTNAME=[hostname] # 수정 / 재부팅시 유지

[root@tez ~]# vi /etc/hosts

127.0.0.1 localhost localhost

::1 localhost localhost

[자기 IP] [hostname] # 추가

CentOS 7

[root@tez ~]# hostnamectl set-hostname [hostname]

[Data] Date command

Tez.Park — Sun, 25 Sep 2016 17:15:11 +0900

현재 날짜와 시간을 YYYY-MM-DD HH:MI:SS 형식으로 출력

$ date '+%Y-%m-%d %H:%M:%S'

2016-08-21 16:50:03

현재 날짜를 특정 날짜로 설정

$ date '+%Y-%m-%d' -s "2016-08-21"

2016-08-21

현재 시간을 특정 시간으로 설정

$ date +%T -s "16:50:00"

date와 time 을 동시에 지정

- date mmddggmmyyy.ss

$ date 082116502016.03

2016. 08. 21. (일) 16:50:03 KST

Check Linux OS type, Version

Tez.Park — Sun, 25 Sep 2016 17:13:37 +0900

배보판 버전 확인

방법1

[root@tez ~]# grep . /etc/*-release

/etc/centos-release:CentOS Linux release 7.2.1511 (Core)

/etc/os-release:NAME="CentOS Linux"

/etc/os-release:VERSION="7 (Core)"

/etc/os-release:ID="centos"

/etc/os-release:ID_LIKE="rhel fedora"

/etc/os-release:VERSION_ID="7"

/etc/os-release:PRETTY_NAME="CentOS Linux 7 (Core)"

/etc/os-release:ANSI_COLOR="0;31"

/etc/os-release:CPE_NAME="cpe:/o:centos:centos:7"

/etc/os-release:HOME_URL="https://www.centos.org/"

/etc/os-release:BUG_REPORT_URL="https://bugs.centos.org/"

/etc/os-release:CENTOS_MANTISBT_PROJECT="CentOS-7"

/etc/os-release:CENTOS_MANTISBT_PROJECT_VERSION="7"

/etc/os-release:REDHAT_SUPPORT_PRODUCT="centos"

/etc/os-release:REDHAT_SUPPORT_PRODUCT_VERSION="7"

/etc/redhat-release:CentOS Linux release 7.2.1511 (Core)

/etc/system-release:CentOS Linux release 7.2.1511 (Core)

방법2

배포판의 버전을 가장 쉽게 확인하는 방법
보안 등의 이유로 다른 내용으로 바뀌어 있는 경우도 있음 (아래처럼)

[root@tez ~]# grep . /etc/issue*

/etc/issue:\S

/etc/issue:Kernel \r on an \m

/etc/issue.net:\S

/etc/issue.net:Kernel \r on an \m

방법3 : rpm 계열에서 사용

[root@tez ~]# rpm -qa *-release

centos-release-7-2.1511.el7.centos.2.10.x86_64

커널 버전 확인

방법1

[root@tez ~]# uname -r

3.10.0-327.18.2.el7.x86_64

방법2 : 레드햇 계열

[root@tez ~]# cat /proc/version

Linux version 3.10.0-327.18.2.el7.x86_64 (builder@kbuilder.dev.centos.org) (gcc version 4.8.3 20140911 (Red Hat 4.8.3-9) (GCC) ) #1 SMP Thu May 12 11:03:55 UTC 2016

[Dump] Export/Import Database

Tez.Park — Sun, 21 Aug 2016 21:47:00 +0900

Export Database in MySQL

특정 Database만 dump

# One Database

$ mysqldump -u root -p dbname > dbname.sql

# Schema only

$ mysqldump -u root -p --no-data dbname > dbname_schema.sql

전체 Database dump

# All databases

$ mysqldump -u root -p --all-databases > alldatabases.sql

# Schema only

$ mysqldump -u root -p --no-data --all-databases > alldb_schema.sql

dump를 하면 database lock이 걸릴수 있기 때문에 lock이 걸리면 안되는 경우 아래 옵션을 사용해준다

--routines --triggers --skip-lock-tables --single-transaction

# One Database - no lock

$ mysqldump -u root -p --routines --triggers --skip-lock-tables --single-transaction dbname > dbname.sql

# All databases - no lock

$ mysqldump -u root -p --routines --triggers --skip-lock-tables --single-transaction --no-data --all-databases > alldatabases.sql

Import dump in MySQL

database, schema only dump 모두 같은 명령어 사용

$ mysql -u root -p < adddatabases.sql

dump 도중 function 함수를 만들지 못하는 에러가 발생하면 mysql console에 접속해서 아래 작업을 해준다.

mysql > SET GLOBAL log_bin_trust_function_creators='ON';

mysql > flush privileges;

Device Type Checker

Tez.Park — Sun, 21 Aug 2016 21:45:18 +0900

var mobileKeyWords = new Array('iPhone', 'iPod', 'BlackBerry', 'Android', 'Windows CE', 'SAMSUNG');

for (var word in mobileKeyWords){

if (navigator.userAgent.match(mobileKeyWords[word]) != null){

location.href = "보내고 싶은 모바일 경로";

break;

}

Device별 접속정보 예시

iPhone

Mozilla/5.0 (iPhone; U; CPU iPhone OS x_x ~~)

Andrioid

Mozilla/5.0 (Linux; U; Android x.x-update1; ko-kr;~~)

PC (Web)

Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.2; ~~)

[Sync] 원격-로컬 브랜치 동기화

Tez.Park — Sun, 21 Aug 2016 18:15:19 +0900

Sync branch

원격에서 변경된 repository 정보를 로컬에도 반영

삭제된 repository를 동기화 하거나 할 때 유용

$ git remote prune origin

[Color] 출력물에 색 입히기

Tez.Park — Sun, 21 Aug 2016 18:14:22 +0900

Git 명령어 출력물에 색 입히기

아래 config 옵션을 추가해주면 git status나 git diff 등을 할때 흑백의 텍스트가 아니라 빨간색, 녹색 등의 색상을 입힌 출력결과를 표시해준다

git config --global color.branch auto

git config --global color.diff auto

git config --global color.interactive auto

git config --global color.status auto

적용한 색상을 다시 되돌리고 싶으면 auto 부분을 false로 변경하면 됨.

Git diff 에 색상 넣기

$ diff old new | colordiff

$ colordiff old new

[Link] Symbolic link

Tez.Park — Sun, 21 Aug 2016 18:10:17 +0900

다른 위치에 있는 파일을 참조하여 사용할때 symbolic link 를 생성하여 사용할 수 있다.

Create a symbolic link

$ ln -s {/path/to/file-name} {link-name}

Delete a link

$ rm {link-name}

[치환] 파일 내부 문자 치환 (폴더 내 모든 파일)

Tez.Park — Sun, 21 Aug 2016 18:08:53 +0900

파일 내부 문자 치환

파일 내부의 문자열을 검색해서 모든 문자를 치환한다

폴더 내부 하위 파일들을 모두 탐색하여 치환한다

$ find ./ -type f -exec perl -pi -e "s#[original]#[replace]#g" {} \;

“s#[original]#[replace]#g”
“s# 과 #g” 으로 시작과 끝을 표시하고
기존 문자열과 바꾸려는 문자열 사이는 # 으로 구분한다.
주의 : 기존 문자열에서 띄어쓰기를 한 후 #으로 구분하면 띄어쓰기까지 하나의 문자열이 되어 인식된다

[압축] Tar 압축하기/풀기

Tez.Park — Sun, 21 Aug 2016 18:08:14 +0900

tar 로 압축하기

$ tar -cvf [파일명.tar] [폴더명]

# ex) items라는 폴더를 items.tar로 압축하고자 한다면

$ tar -cvf items.tar items

tar 로 압축 풀기

$ tar -xvf [파일명.tar]

#ex) items.tar라는 tar파일 압축을 풀고자 한다면

$ tar -xvf items.tar

tar.gz 로 압축하기

$ tar -zcvf [파일명.tar.gz] [폴더명]

#ex) items라는 폴더를 items.tar.gz로 압축하고자 한다면

$ tar -zcvf items.tar.gz items

tar.gz 압출 풀기

$ tar -zxvf [파일명.tar.gz]

#ex) items.tar.gz라는 tar.gz파일 압축을 풀고자 한다면

$ tar -zxvf items.tar.gz

tar 명령어 옵션들

-c : 파일을 tar로 묶음

-p : 파일 권한을 저장

-v : 묶거나 파일을 풀 때 과정을 화면으로 출력

-f : 파일 이름을 지정

-C : 경로를 지정

-x : tar압축을 푼다

-z : gzip으로 압축하거나 해제

[비교] 파일/폴더 내용 비교

Tez.Park — Sun, 21 Aug 2016 18:07:26 +0900

파일/폴더 내용 비교

파일 또는 폴더 비교를 위해 diff 스크립트를 이용한다.

#파일

diff -r [fileA] [fileB]

#폴더

diff -r [folderA]/ [folderB]/

결과에 색 넣기

비교 결과에 색을 함께 출력하고 싶을 경우 colordiff를 이용한다.

colordiff 이 없는 경우 설치

# Install colordiff

## Linux/RHEL

$ yum -y install colordiff

## OS X

$ brew install colordiff

# Use

#파일

diff -r [fileA] [fileB] | colordiff

#폴더

diff -r [folderA]/ [folderB]/ | colordiff

[권한] 파일,폴더 권한 확인/설정

Tez.Park — Sun, 21 Aug 2016 18:06:12 +0900

권한 확인

$ ls -l #long format 으로 조회

drwxr-xr-x 5 tezpark staff 170 11 9 2015 Public/

drwxr-xr-x 4 tezpark staff 136 11 30 11:01 Sites/

....

목록에 표시되는 왼쪽 부분이 (drwxr-xr-x) 권한 정보를 나타냄

예제에서 보이는 권한 정보에 표시되는 문자열은 아래를 의미한다.

d rwx r-x r-x

파일타입 User권한 group권한 other권한

파일타입

- : plain file. 일반 파일. 실행 파일도 포함한다.
d : directory. 디렉토리 형식.
l : link. 다른 파일을 가리키는 링크 파일.
p : pipe. 두 개의 프로그램을 연결하는 파이프 파일.
b : block device. 블럭 단위로 하드웨어와 반응하는 파일.
c : character device. 스트림 단위로 하드웨어와 반응하는 파일.

권한타입

- : 권한 없음
r : Read (읽기)
w : Write (쓰기)
x : Execute (실행)

권한 설정

$ chmod [권한] [파일]

chmode = change mode 의 약자

사용은 아래와 같이 한다

$ chmod 755 test # test파일의 권한을 rwxr-xr-x 로 설정한다.

$ chmod 654 test # 654 = rw-r-xr--

$ chmod 4 test # -> chmod 004 test 와 같다

심볼 숫자 값

r = 4
w = 2
x = 1
- = 0

숫자 조합 값

rw- = 4 + 2 + 0 = 6
r-x = 4 + 0 + 1 = 5
rwx = 4 + 2 + 1 = 7

하위 폴더까지 권한주기

$ chmod -R [권한] [파일]

[검색] n일 이내에 수정된 파일 찾기

Tez.Park — Sun, 21 Aug 2016 18:05:16 +0900

n일 동안 수정된 파일 찾는 방법

find [폴더] -type f -mtime -[일수] -print
find [폴더] -type f -mtime -[일수] -ln

case 1

[root@tez ~]# find /var/log/ -type f -mtime -1 -print

/var/log/lastlog

/var/log/audit/audit.log

...

case 2

[root@tez ~]# find /var/log/ -type f -mtime -1 -ls

17148395 36 -rw-r--r-- 1 root root 292876 Aug 1 11:17 /var/log/lastlog

1112036 1668 -rw------- 1 root root 1452833 Aug 1 11:17 /var/log/audit/audit.log

[검색] 파일 검색, 파일 내부 문자열 검색

Tez.Park — Sun, 21 Aug 2016 18:04:10 +0900

파일 검색

$ find [위치] -name [파일명]

# example

$ find / -name index.html

$ find / -name *ndex.*

/ 는 전체경로에서 찾는것
*ndex.* 는 *과* 사이에 있는 문자가 포함된 파일 검색

파일 내부 문자열 검색

-r 옵션을 사용하면 파일 내부를 검색 가능

grep -r "찾을 문자열" ./*

[S3Cmd] S3 사이즈 확인

Tez.Park — Sun, 21 Aug 2016 18:01:39 +0900

Server에서 S3 버킷의 용량을 확인하는 방법

설치

우선 s3cmd 패키지를 다운받아 설치 후 s3cmd 설정을 해주자

$ wget http://downloads.sourceforge.net/project/s3tools/s3cmd/1.6.1/s3cmd-1.6.1.tar.gz

$ tar zxf s3cmd-1.6.1.tar.gz

$ cat INSTALL|more

$ python setup.py install

$ s3cmd --configure

확인

옵션을 통해 Human readable type과 일반 타입으로 볼 수 있다.

$ s3cmd du -H s3://'[bucket-name]' # Human readable

$ s3cmd du s3://'[bucket-name]'